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Preface 


The  Dh.Cnrt  RSX  S\strm  .\fam^rr's  (;uld^'  {)resenls  intormation  needed  to 
manage  a  DECnel  RSX  node  within  a  DKCnet  network.  The  term  DKC- 
net-RSX  collectively  refers  to  three  DKC^net  products: 

•  DECnet-llM.  which  runs  on  RSX   llM 

•  DEC'net   IIM   FIT'S,  which  runs  on  RSX   llM  PUS 

•  DP:Cnet-llS,  which  ruii .  on  RSX   1  IS 

This  manual  also  describes  system  management  procedures  tor  RSX  11  I\SI 
and  DECnet-RSX,  PSI.  The  term  DECnet  RSX  TSI  refers  to  an  RSX  system 
that  runs  RSX  11  PSI  and  DEfnet  RSX  simultaneouslv.  B..th  DEC- 
net-RSX  and  RSX-11  PSI  products  omform  to  the  Digital  Network  Architec- 
ture (DNA).  DNA  is  the  model  tor  all  DECnet  implementatmns  and  the 
standard  that  allows  different  Digital  operating  systems  to  participate  in  the 
same  network.  The  DNA  model  contains  the  (\)mite  Tonsultatif  International 
Telegraphique  et  Telephonique  (CCITl^)  recommendation  X.2o.  which  de- 
fines a  standard  interface  from  a  computer  or  terminal  to  a  packet-switchii  g 
network  (PSN).  The  RSX  1 1  PSI  product  implements  the  (TTIT  recommen- 
dation X.25  to  enable  an  RSX  operating  system  to  participate  in  a  PSN. 

The  utilities  described  in  this  manual  are  used  to  manage  DECnet  iM  V4  0 
DECnet-llS  V4.0,  and  nECnet-llM  PLUS  Vj.r)  nodes.  Vou  can  use  these 
utilities  to  manage  both  local  and  rem.ote  DECnet  systems  whirh  may  be 
other  than  RSX  based.  Although  Phase  IV  DECnet  provides  for  cross-svstem 
network  command  operation,  there  are  also  .some  system-specific  commands. 
RSX  sy.stem-.specific  commands  are  flagged  in  Appendix  A  For  implementa- 
tions other  than  DECnet-RSX,  refer  to  the  system  manager's  guide  for  that 
system. 

Intended  Audience 

This  manual  is  intended  for  anvone  who  is  resp)onsible  for  building,  maintain- 
ing, and  mansyvny-  the  network  In  ihi«  manual,  aii  such  neonie  arc  coiicc- 
tivelv  referre"  '■'•■  m^^  iIm-  ^v.!? 
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Structure  of  This  Manual 

This  manual  is  tab  divided  into  five  distinct  parts.  The  first  part  is  strictly 
tutorial  in  nature  and  serves  to  point  the  user  to  the  specific  reference  mate- 
rial found  in  the  other  four  parts.  The  pa-ts  and  their  contents  are  summa- 
rized below. 

Part  I  —  Tutorial 

Chapter  1  —  Networit  Management  Over/iew 

Provides  an  overview  of  network  management  as  it  relates  specifically  to 
DECnet-RSX  and  briefly  introduces  the  various  network  management  tools 
and  utilities. 

Chapter  2  —  Network  Management  Components 

Describes  the  basic  DECnet-RSX  components  and  summarizes  the  CFE, 
NCP,  and  V^NP  commands  and  parameters  relevant  to  each. 

Chapter  3  —  Operating  DECnet-RSX/PSI  Nodes 

Describes  how  to  start  up  and  shut  down  a  loc. '.  DECnet-RSX  or  DEC- 
net-RSX/PSI node.  Also  includes  information  on  how  to  monitor  network 
activity  (using  display  commands  and  event-logging  messages)  and  how  to 
test  network  operation  (using  loopback  tests  and  the  trace  facility). 

Chapter  4  —  Supporting  Remote  RSX-llS  Systems 

Describes  down-line  loading  and  up-line  dumping  of  RSX-llS  svstems  and 
down-line  task  loading  for  PSX-1  IS. 

Chapter  5  —  Choosing  Network  Buffer  Parameters 

Describes  the  allocation  and  usage  of  the  various  system  buffers. 

Part  II  —  CFE,  NCP,  and  VNP 

Chapter  6  —  Network  Management  Utilities  (CFE,  NCP.  VNP) 

Describes  the  format,  parameters,  and  usage  of  all  CFE,  NCP.  and  VNP 
commands. 

Part  HI  —  Network  Management  Tools 

Each  of  the  chapters  in  Part  III  describes  the  operation  of  a  network  manage- 
ment tool,  including  commands  for  its  operation  and  examples  of  its  use 
and/or  output  (where  applicable). 

Chapter  7  —  Console  Carrier  Requester  (CCR) 

Chapter  8  —  Host  Task  Loader  (HLD) 

Chapter  9  —  KMX  Dump  \nalyzer  (KDA) 

Chapter  10  —  Network  Dump  Analyzer  (NDA) 

Chapter  11  -  Network  Display  Program  (NTD) 

Chapter  12  —  Queue  Mana{,'er  (QUE) 

Chapter  13  —  Trace  Interpreter  Task  (TRI) 
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Part  IV  —  Error  Messages 

Chapter  14  —  Utility  Error  Messages 

Summarizes  all  error  messages  for  the  following  tools  and  utilities-  CCR 
CFE,  HLD,  NCP,  NDA.  \TD,  XTIXIT,  XTL.  TRI,  VXP. 

Part  V  —  Appendixes 

Appendix  A  -  CFE.  XCP,  and  VXP  Command  Summarv' 

Summarizes  all  CFE,  XCP.  and  VXP  commands  and  their  parameters   and 
identifies  those  that  are  RSX  system  specific. 

Appendix  B  —  Object  Type  Codes 

Lists  all  valid  object  type  codes  with  their  process  types. 

Appendix  C  —  Xetwork  Management  Event  Logger  Interface 

Describes  the  network  management  logging  monitor  interface  that  vou  can 
use  to  enable  a  user-written  program  to  process  network  events. 

Appendix  D  —  Event  Class  and  Type  Summary 

Describes  the  event  message  format  and  lists  all  event  messages  bv  class  and 
type,  including  a  brief  description  of  each. 

Appendix  E  —  Xetwork  Counter  Summary 

Lists  all  counters  maintained  by  the  network  for  lines,  circuits,  nodes,  mod- 
ules, and  the  system,  and  gives  a  brief  descripticm  of  each. 

Appendix  F  —  Xetwork  Parameter  and  Counter  Type  Xumbers 

Lists  all  network  parameter  and  counter  type  numbers  recognized  by  DEC- 
net-RSX  network  management  software. 

Associated  Documents 

Before  reading  this  manual,  you  should  have  a  workin-  knowledge  r  f  DECnet 
and  the  RSX-11  operating  system  you  are  using.  A  prerequisite  to  the  effec- 
tive use  of  this  manual  is  familiarity  with  the  overall  character  of  DE(  net  as 
described  in  the  following  manuals: 

Introduction  to  DECnet  {order  no.  AA-.h)nr>D-TC) 
Ovenieu-  of  DECnct-RSX  (order  no.  AA-M()96B-TC) 

Programming  and  user  utility  information  (including  PSI  programming  facili- 
ties) concerning  DECnet-RSX  is  contained  in  the  f.)llowing  manuals: 

DECnet-RSX  Guide  to  I'ser  I'tilities  (order  no.  AA-H22aC-TC) 
DECnet-RSX  Programmer's  Reference  Manual  (order  no.  AA-M()98B-TC) 
RSX- II  f\SI  I'ser's  Guide  (order  no.  AA-Ma71A-TC) 
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Network  generation  and  post  installation  checkout  procedures  are  described  in 
the  following  manuals: 

DECnct-RSX    Network    Generation    and    Installation    Guide    (order    no. 
AA-H225C-TC) 

DKCnet-RSX     Postinstallatiun     Checkout     Procedures     (order     no. 
AA-J319C-TK) 

RSX-U  PSI  Generation  Guide  (order  no.  AA-Ma72A-TC) 

Documentation  for  other  Digital  Ethernet  Communications  Server  (DECS) 
products  includes: 

Introduction  to  Local  Area  Xetirorks  (order  no.  EB-22714-18) 

Xetworks:  Ethernet  I^oducts  and  Services  Catalog  (order  no.  ED- 25484-42) 

DECnet    Router    Server    Installation    and    Operation    Guide    (order    no 
AA-X()19A-TK) 

DECnet  Router/X.25  (lateuax  Installation  and  Operation  Manual  (order  no 
AA-Y666A-TK) 

Terminal  Server  Installation  and  Operation  Guide  (order  no.  AA-X02()A-TK) 

Other  manuals  that  contain  information  related  to  the  material  covered  in 
this  manual  are: 

RSX-IIM  System  Generatitm  and  Installation  Guide  (order  no. 
AA-H625B-TC) 

RSX-IIM  Guide  to  Writing  an  I/O  Driver  (order  no.  AA-26()(JE-TC) 

RSX-IIM/M-PIA'S  Task  Builder  Manual  (order  no.  AA-L68()A-TC) 

RSX-UM/M-PLUS  Sysiem  Management  Guide  (order  no.  AA-L679A-TC) 

RSX-llM/M-PIA'S  Batch  and  Queue  Operations  Manual  (order  no. 
AA-L671A-TC) 

RSX-IIM/M-PIA'S  i'tilities  Manual  (order  no.  AA-L681A-TC) 

RSX-11  PSI  System  Manager's  Guide  (order  no.  AA-M370A-TC) 

DECnet-VAX  System  Manager's  Guide  (order  no.  AA-K803C-TE) 

Terminals  and  Communications  Handbook  (order  no.  EB-207o2-20) 

9 

Information  on  using  PSI  for  a  specific  subscription  service  is  contained  in  the 
RSX-11  PSI  Xetuork-specific  Information  manual  (order  no. 
AA-M373A-TC). 
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An  overview  of  the  Digital  Network  Architecture  (DNA)  is  provided  in  the 
following  manual: 

DECnct  Digital  Xetwork  Architecture  (Phase  IV)  (Inieral  Descriptinn  (order 
no.  AA-X149A-TC)  a  ^    uti 


ase 


The  following  functional  specifications  provide  detailed  descriptions  of  Ph^ 
Iv  DNA  protocols: 

DXA  Xetunrk  Management  Functional  Specification,  Versuni  4  0  (i  (order  no 
AA-X437A-TK) 

DNA  Xetuork  Services  Protocol  Functional  Specification.   Version  ■/  0  0  (or- 
der no.  AA-X439A-TK) 

DXA  Digital  Data  Communicutions  Message  Protocol  fDDCMP)  Functional 
Specification.  Version  4.1.0  (order  no.  AA-KlToA-TK) 

DNA  Data  Access  !W>tocol  (DAP)  Functional  Specificati<,n.    Version  560 
(order  no.  AA-K177A-TK) 

DXA  Maintenance  Operations  Functional  Specification.  Version  :i  o  0  (order 
no.  AA-X4.S6A-TK) 

DXA    Ses.sion    Control  Functional  Specification.    Ver.sion    loo   (order  no 
AA-K182A-TK) 
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The  Ethernet.  A  Local  Area  Xetuork.  Data  Link  La\er  and  Physical  Laye 
Specifications,  Version  2.0.0  (order  no.  AA -K759B-'rK) 

/;.V4  Ethernet  Xode  Product  Architecture  Specification.  Ver.sion  I  0  0  (order 
no.  AA-X440A-TK) 

A '7't'.facffT/^  ^^"^"  ^^"'^'  A'i/m'?/or7«/  Specification.   Version  LOO  (order  no. 
ffv.^-"/'^^^^^'''''   ^^^"^•^'^^"«/   Specification,    Version   2.0.0   (order   no 

NOTE 

The  DXA  Routing  Layer  Functional  Specification  supercedes 
the  Phase  III  Transport  Functional  Specificatum.  In  the  DE(- 
net-RSX  Sy.stem  Manager's  (iuide.  the  Routing  laver  is  some- 
times referred  to  as  the  Transport  laver. 
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Acronyms 

The  following  acronyms  for  DECnet  RSX  and  FSI  components  are  used  in 
this  manual: 


ACK 

BCUG 

CCB 

CCITT 

CCR 

CCS 

CDA 

CEX 

CFE 

CSR 

CUG 

DAP 

DCB 

DCE 

DDCMP 

DOM 

DECS 

DLC 

DLL 

DLM 

DLX 

DNA 

DSR 

DTE 

DTR 

DUK 

DUM 

ECL 


Positive  acknowledge  message 

Bilateral  closed  user  group 

Communication  control  buffer 

Comite  Consultatif  International  Telegraphique  et  Telephonique 

Console  carrier  requester 

Console  carrier  ser\er 

Crash  dump  analyzer 

Communications  Executive 

Configuration  File  Editor 

Control  status  register 

Closed  user  group 

Data  Access  Protocol 

Device  control  block 

Data  circuit-terminating  equipment 

Digital  Data  Communications  Message  Protocol 

Device  driver  module 

Digital  Ethernet  Communications  Server 

Data  link  control  process 

Down-line  system  loader 

Data  link  mapping 

Direct  Line  Access  Controller 

Digital  Network  Architecture 

Dynamic  storage  region 

Data  terminal  equipment 

DECnet  test  receiver 

Dump  KMX  task 

I  p-line  system  dumper 

End  Communication  laver 
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EVL 

EVR 

FAL 

FRMR 

FTQ 

FTS 

HLO 

ICB 

KDA 

KRB 

LAPB 

LDB 

LLC 

LUN 

MIR 

MOP 

NAK 

NCR 

NDA 

NFT 

NICE 

N(R) 

MS 

NTD 

NTDEMO 

NTINIT 

NTL 

NW 

OOT 

PIP 


Event  Logger 

Event -lo^^in^  receiver 

File  Access  Listener 

Frame  reject  error 

File  transter  queue  manager 

File  Transfer  Spooler 

Host  Task  Loader  utility 

Interrupt  control  block 

K\L\  dump  analyzer 

Controller  request  block 

Link  access  procedure.   Version  B  (('(TIT  ren.mmendation  tur 
trame  level  protocol! 

Large  data  butler 

Logical  link  control  process 

Logical  unit  number 

Loopback  mirror 

Maintenance  Operation  Protocol 


N 


egative  acknowledge  message 


Network  Ccmtrol  P 


rogram 


Network  Dump  Analyzer 

Network  File  Transter  utility 

Network  Information  and  Control  Exchange  Pn.tocol 

Next  expected  se^^uence  number 


DEC 


net  user  interface  pseudodevice 


Net 


work  Displav  F^rogram 


Network  display 


^erver 


Netw(»rk  Initial 
Network  loader 


izer 


PS  I 


user  interface  pseudodevice 


()n-lme  debugginj,  Tf>n| 
Peripheral  Interchange  Program 
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PLI 

PSI 

PSN 

PVC 

QUE 

RAM 

RDB 

RNR 

SCB 

SOB 

SLD 

SVC 

TKB 

TRI 

JCB 

UFD 

UIC 

UMR 

URB 

VNP 

XDT 

XPT 


PSI  paiket  level  iiilertaie 
Packet  net  Sy>iern  hitertace 
Packet -switching  network 
Permanent  virtual  circuit 
C^ueue  manager 
Ranci.im  access  memory 
Receive  data  butler 
Receive  not  ready 
Status  control  block 
Small  data  butler 
Satellite  task  loader 
Switched  virtual  circuit 
RS\  task  builder 
Trace  interpreter  task 
I  nit  control  block 
\\0r  fie  directory 
I  ser  identification  code 
rXIBl'S  mapping  register 
r^er  request  block 
\'irtual  Network  Processor 
Executive  debugging  tool 
Transport  layer 
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Graphic  Conventions 


• 


The  following  conventions  are  used  throughout  this  manual. 
DOT  MATRIX  TYPE   is  used  for  examples  of  system  input  or  output. 

RED   INK 


shaded  text 


UPPERCASE 


lowercase  italic 
brackets  [  ] 


is  used  in  examples  to  indicate  user  input.  Black  type  rep- 
resents system  prompts  or  displays. 

in  command  formats  (Chapter  6  and  Appendix  A  only) 
Hags  commands  and  parameters  that  are  valid  lor  PSI 
users  only  (including  DLM). 

represents  actual  characters  that  you  must  enter  in  com- 
mands. 

NOTE 

Uppercase  words  can  be  abbreviated  to  the 
first  3  or  more  unique  characters. 

indicates  variables  whose  value  you  must  specify. 

specify  that  the  enclosed  data  is  optional.  All  text  not  en- 
closed by  brackets  is  required.  For  most  commands  in 
Chapter  6,  you  must  choose  at  least  one  of  the  parameter 
options  (see  Chapter  6  for  details).  Do  not  type  the  brackets 
when  you  enter  a  command. 

indicate  that  you  must  choose  one  (and  onlv  one)  of  the 
enclosed  o'  ions.  Do  not  type  the  braces  when  vou  enter  a 
command. 

are  decimal  unless  otherwise  noted. 

means  that  you  must  press  the  CTRL  key  and  the  specified 
character  key  simultaneously. 

means  that  you  should  press  the  RETURN  key.  Even  when 
It  IS  not  shown  in  examples,  you  should  alwny  press  RE- 
TURN to  enter  a  command  line. 

means  that  you  should  press  the  ESC  key. 

means  that  you  should  press  the  line  feed  key. 

Example: 

CLEAR    (u\E  line-id        \      /aLL  ^^ 

|KNO\VN  LINESj      \ COUNTER  TIMEr| 

When  issuing  this  command,  you  must  include  a  specific  line  ID  (for  example 
DMC-(  )  or  specify  the  KNOWN  LINES  keyword.  Then  vou  must  specifv 
either  ALL  or  COUNTER  TIMER  (the  latter  is  valid  for  Psi  users  onlvl  Vou 
can  aKso  abbreviate  the  words,  as  shown  in  the  following  sample  command: 

NCP  CLE  LIN  CMC-O  ALL  b£' 


braces 


numbers 

^K2 


'^ 


Isc: 
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Chapter  1 

Network  Management  Overview 


This  chapter  provides  a  brief  overview  of  DECnet-RSX.  with  an  emphasis  on 
topics  that  pertain  to  managing  local  and  remote  DECnet  nodes.  This  over- 
view describes  the  kinds  of  network  configurations  in  which  DECnet-RSX 
nodes  can  participate  and  introduces  the  data  bases  and  utilities  you  use  to 
control  a  node's  performance. 


1.1    DECnet  Interface  with  RSX  Operating  Systems 


DLCnet  is  the  collective  name  for  the  software  and  hardware  products  that 
allow  various  Digital  operating  systems  to  participate  in  a  network.  DEC- 
net-RSX IS  the  software  implementation  that  enables  an  RSX-llM, 
RSX-llM  PLUS,  or  RSX-llS  operating  system  to  function  as  a  network 
node.  As  the  RSX  network  interface.  DECnet-RSX  supports  both  the  proto- 
cols necessary  for  communicating  over  the  network  and  the  functions  neces- 
sary for  configuring,  controlling,  and  mcmitoring  nodes.  A  DECnet-RSX  node 
can  communicate  with  other  DECnet-RSX  nodes  in  the  network  or  with  any 
other  Digital  operating  system  that  supports  DECnet. 

A  DECnet  network  is  decentralized:  nodes  connected  to  the  network  can 
c()mmunicate  with  each  other  without  haN-ing  to  go  through  a  central  node 
There  is  no  hierarchy.  Instead,  all  nodes  are  "peers"  and  thus  do  not  depend 
on  the  availability  of  a  node  on  a  higher  level.  Each  node  can  communicate 
witfi  any  other  node  in  the  network  to  gain  access  to  its  resources. 


1,2    RSX-11  Packetnet  System  Interface  (PSI) 


RSX-ll  PSI  is  the  .software  product  that  allows  vou  to  participate  in  a 
packet-switching  environment.  A  packet-.switching  network  (PSN)  consists  of 
switching  nodes  (network  interfaces  called  data  circuit-terminating  equip- 
nient  or  DCEs)  connected  by  links.  The  computers  or  terminals  attached  to 
the  PSN  are  called  data  terminal  equipment  (DTE)  and  u.se  Digital's  imple- 
mentation of  the  X.25  protocol  to  communicate  with  the  PSN. 

RSX-11  PSI  can  be  used  both  for  direct  communication  with  other  X  25 
L  V  'i!^^''^■^''^  equivalent  of  a  node)  and  for  linking  DECnet  nodes  across  a 
1  SN.  I  he  latter  capability,  where  an  X.25  virtual  circuit  is  u.sed  as  a  DECnet 
data  link,  is  known  as  data  link  mapping  (DLM).  In  addition,  a  computer  or 
terminal  can  be  attached  directly  to  an  X.25  PSN  without  using  DEC^net. 
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Figure  1-1:    Phase  IV  Configuration 


1.3    DECnet  Configurations 


DKCnet  RSX  supports  n.nnections  t„  both  local  area  and  wide  area  net- 
works: 

•  Local  area  network  connections  are  provided  hv  the  Kthernet  and  its  com- 
patible hardware. 

*  nrv^u'^''  "'^^'"'""^  connections  are  provided  hv  various  means,  including 

)U(  AL    pomt-to-po,nt  and  multipoint  devices  and  data  link  mappin^:  to  a 

nLv'''^  ^  il  -V. ''  "^'''^'"'"^  "'  ''  '•■''''■^'  ''^^^'^'  '^'  <''>nnKuration  that  includes 
I)K  net  R.SX  and  I^KCnet  VAX  nodes  on  an  Kthernet.  as  well  as  DDCMP 
mu  tipomt  connections  and  data  link  mappi  ig  via  an  X.2o  PSN  to  remote 
I)K(  net  nodes.  .As  the  ti^ure  shows,  a  DK^net  RSX  node  can  participate  in  a 
wide  area  network  and  a  local  area  network  simultaneouslv.  See  the  Intmciuc- 
tinn  to  DhCru^t  tor  more  inlormation  ah,.ut  DKCnet  configurations 


1.4    l\1anaging  the  Network 


As  system  manager  ot  a  DKCnet   K.sX  network, 
responsibilities,  which  include: 


you  have  a  number  ol  kev 


At  NKTCiKX.  det 


ining  network  components  and  their  t)aramet 


tral  data  ba.^c  at  the  h.cal  nod 


iguring  your  node  to  ensure  proper  network  operat 


ers  m  a  cen- 


with  other  nodes  in  the  network  (This  incl 


F)eration  in  accordance 


none  names. 


butle 


udes  defining  node  add 


resses. 


the  routing  topology  ol  the  network. 


r  sizes,  and  circuit  costs,  all  ot  which  parameters  atlect 


•  Controlling  and  monit 


oring  local  and  remote  network  operat 


ion 


'esting  network  hardware  and  softw- 


are operation 


Load 


ing  systems  down  line  to  remote  nodes 


If  your  node  includes  RSX   11  VSl. 


you  have  the  following  responsibilit 


les: 


Def 


ining  RSX   II    PSI 


configuration  data  ba.se  and  th 


components  and  their  parameters  in  th 


e  network 


u 


s  configuring  RSX    11  VS\ 


•  Monitoring  the  operation  of  RSX-11  PSI 


•  Analyzing  hardware  and  .softw 


are  operation  and  diagnosing  problem,* 
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1.5    DECnet-RSX  Data  Bases  and  Utilities 

Network  data  bases  provide  the  information  that  a  DKCnet   RSX  node  needs 
to  tunelion  as  part  ot  a  network.  DKCnet   HSX  data  bases  include: 

•  The  permanent  data  base 

•  The  volatile  data  base 

•  The  system  ima^'e  tile 

Vou  use  a  different  utility  to  modity  or  define  each  data  base: 

•  The  ConfiiTuration  File  Editor  iCFKl  modifies  the  permanent  data  ba>e. 

•  The  Network  Control  Program  (NCIM  modifies  the  volatile  data  base. 

•  The  N'irtual    Network    Processor  (\'NPi    modifies  the  .system   image  file. 
(DhX^net   HSX   IIM   PITS  does  not  >upi)ort  VNIM 

Chapter  fi  describes  the  command  syntax  tor  the  three  utilities  and  provides 
individual  command  descriptions  in  alphabetical  order.  The  utility  (.r  utilities 
to  which  each  command  applies  appear^  at  the  top  oi  the  page.  (Many  NCI* 
and  \NP  commands  have  the  same  format  and  definition  and  are  therelore 
described  together.)  Krror  messages  tor  CFK.  NC1\  and  \NI».  as  well  as  other 
network  management  io<.ls  (see  Section  l.Ti.  are  described  in  Chapter  14. 

1.5.1  The  Permanent  Data  Base  and  the  CFE  Utility 

The  permanent  data  base  is  the  configuration  file  CFTAH.MAC.  which  is  a 
product  of  NKTCKN.  CK  TAB. MAC  contains  the  data  base  used  to  load  the 
configuration  defined  at  NKTCFA'.  Parameters  in  the  permanent  data  ba.se 
are  u.sed  by  DF'Cnet  HSX  software  whenever  you  load  the  Communications 
Kxecutive.  \uw>.  circuits,  and  the  X.2.")  X.29  modules  (for  systems  with  a  PSI 
capabilityl.  The  copy  of  CKT.\B..\IAC  in  memorv  after  you  have  loaded 
DKCnet  HSX  is  the  volatile  data  ba.^e.  The  CFK  utility  modifies  only  the 
CKTAH..MAC  permanent  data  base.  When  you  use  CFK.  the  modifications  to 
the  generated  system  do  not  come  into  effect  until  the  next  time  you  load  the 
affected  [)art  of  the  network  software. 

1.5.2  The  System  Image  File  and  the  VNP  Utility 

The  system  image  file  is  the  HSX  11  operating  system  that  is  loaded  from 
disk  into  memorv  when  the  .system  i>  booted.  You  u.^e  \'NP.  a  privileged 
utility,  to  add  the  DKCnet  HSX  software  to  the  disk  svstem  image  file  or  to 
moditv  the  DKCnet   HSX  software  already  present  there.  iHSX    llM   PIJ  S 


does  not  support  \'.\P.i  \'NP  is  comparable  to  the  Virtual  Con.Nole  Monit 


or 


Houtine  (\'MH).  the  utilitv  v 
operating  system  imatre 


ou  use  to  modify  the  HSX    MM  or  HSX    US 
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v'XP  does  not  chariKe  the  network  software  running  in  main  nu-niorv  XA}' 
^•han,^es  that  sou  make  to  the  svstem  ima^e  lUe  on  (h.sk  come  into  etiect  the 
next  time  the  operating  system  i>  reh<.oted. 


1.5.3    The  Volatile  Data  Base  and  the  NCP  Utility 

orv  and  M  I  ,s  he  iHihtv  vou  use  to  mod.tv  it.  When  vou  [.rin^  the  sv.tem 
up.  the  volatile  data  hase  includes  intormation  from  the  CKTAH  MAC  tile 
(  hanfjes  vou  make  usin^  NCP  remain  in  effect  until  the  >v>tem  ^ne.  down  or 
until  vou  reload  DKCnet  HSX  or  rehoot  the  operating  >vstem  NTP  "m 
m^nds  allow  vou  to  load,  control,  and  monitor  the  running  DKCnet  H^\ 
o.nf.Kuration  as  well  as  to  test  the  network  hardware  and  software  and  t'o 
cUvn-l.ne  load  an  HSX  US  system  ima.e.  If  v.u  have  u>ed  VNP  to  load 
K(  ne  K>\  ,nto  the  svstem  .ma,e  file  on  disk,  vou  automatu-allv  load 
)K(  net  when  vou  hoot  the  system.  Otherwise,  vou  use  NCP  commands  to 


load  the  network  software  after  vou  ho( 


»t  tne  operating  .^v^te 


m. 


There  are  two  versions  of  ^(•f>:  the  lull  complement  supported  hv  DPC 
ne|  M  and  I)KC„et  1 IM  ,>L(  S  and  ..  subset  of  th<.se  commands  lor  I)K( '. 
Tren    ,     hI^I  ^""""^^^^^^  '^'^  ^'^^  ^'''^^"^'ted  both  at  vour  local  svstem  and 

a  remote  I)K(  net  svstems.  (  erta.n  NCP  commands  can  he  executed  onlv  hv 
privileged  users.  Appendix  A  summarizes  both  command  .sets,  specifier  wh-ch 
commands  are  for  privileged  u.^ers  onlv.  and  flags  c-ommands  that  cannot 'be 
executed  remotelv.  (  hapter  i'.  provider  detailed  de.scription.s  of  all  NCI'  com- 
mands and  their  parameters. 


1.6 


Where  NETGEN  Ends  and  System  Management  Beg 


ins 


Th( 


le  netw.,rk  generation  procedure  produces  a  DKCnet   F^SX  system  confiLUi 
ration  with  or  without  a  PSI  capability.  The  sy.tem  includes  a  configura  h  n 

FTARMU    r        •  r    "'""'  ^"^'  '"^^^^*^-  '"''^^  ^-"t'^-ration  fife  ,s  the 
/•        -ru  '       '^^  contains  inf..rmation  collected  during  network  gen- 

eration,    he  command  files  uulude  the  XKTINS.CMI)  ,iU,  which  is  u.sed  to 

ele  t  d  l"'  '"^^  ^':  NKTCFK.CMI)  f,,e.  whu-h  stores  the  parameters 
>ele  ted  during  network  generation;  and  the  XKTHKM.CMI)  file  which  is 
used  to  unl<.ad  the  network  and  remove  network  tasks.  The  network  task 
images  are  those  images  selected  for  your  system  configuration.  (;,ven  the^e 
products  of  the  generation  procedure.  Figure  1   2  provides  a  step-bv-step  walk- 

hrough  of  the  operations  performed  to  pr-  duce  a  running  DKCnet  H.SX  sv.s- 
tern. 


• 
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STEP  1 

Generating  a  DECnet-RSX 

Configuration 


Perform  a  network  genera- 
tion (NETGEN) 

NETGEN  output: 

•  CETAB.MAC 

•  Command  files: 

NETINS.CMD 

NETREM.CMD 

NETCFE.CMD 

•  Network  task  images 

If  necessary,  issue  CFE 
commands  to  modify 
CETAB.MAC.  the  permanent 
data  base. 


STEP  2 
Loading  DECnet  Software 


Load  DECnet  using  one  of 
three  options: 

•  Invoke      NETINS.CIMD 

(installs  network  tasks; 
optionally  loads  DECnet 
from  CETAB.MAC  and 
turns  on  local  node);  or 

•  Issue  NCP  commands 
to  load  DECnet  from 
CETAB.MAC  and  turn 
on  local  node;  or 

•  Issue  VNP  commands  to 
toad  DECnet  from 
CETAB.MAC  into  sys- 
tem image  file;  then  re- 
boot system. 


STEP  3 

Managing  Locai  and 

Remote  Nodes 


Issue  NCP  commands  to: 

•  Modify  the  volatile  data 
base 

•  Test  network  software 

•  Load  remote  systems 

•  Perform  other  manage- 
ment tasks 

Issue  CFE  commands  to 
modify  CETAB.MAC  before 
reloading  DECnet. 

Issue  VNP  commands  to 
modify  the  system  image  be- 
fore rebooting  the  system. 


Figure  1-2:    Producing  a  Running  DECnet-RSX  System 


Though  the  procedures  can  be  iterated  differently  within  each  set.  the  follow- 
ing is  a  sequential  description  of  the  steps: 

1.  Networl(  generation.  Network  generation  provides  the  components  upon 
which  step  2.  loading  the  network,  operates.  The  DECnet-RSX  Network 
Generation  and  Installation  Guide  describes  the  network  generation  pro- 
cedure for  configuring  a  DECnet-RSX  system  with  or  without  RSX-11 
PSI. 

You  can  issue  CFE  commands  to  modify  CETAB.MAC  (the  configuration 
file)  once  it  has  been  created  by  the  network  generation  procedure.  This  is 
useful  for  modifying  configuration  parameters  prior  to  loading  the  net- 
work. 

2.  Loading  the  network.  Once  you  have  configured  the  system,  you  can  load 
the  network  software  into  the  target  configuration  (that  is.  the  actual 
running  configuration  produced  by  the  NETGEN  procedure)  by  invoking 
the  NETINS.CMD  command  file  or  by  using  NCP  or  VNP  commands 
(see  Section  3.1.1).  The  end  product  of  this  step  is  an  active  DECnet-RSX 
configuration  capable  of  participating  in  a  network.  At  this  point,  you 
should  run  the  postinstallation  checkout  procedures,  as  defined  in  the 
DECnet-RSX  Postinstallation  Checkout  Procedures  manual. 

3.  Reconfiguring  and  tuning  the  running  network.  Once  you  have  loaded 
the  network  software,  you  can  use  NCP  to  modify  the  volatile  data  base  to 
enhance  network  performance  and  reconfigure  the  running  network  (for 
example,  turn  circuits  on  or  off  and  enable  or  disable  PSI  network  opera- 
tional. You  can  also  use  NTP  to  test  and  monitor  network  software  opera- 
tion. 
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1.7   Other  Network  Management  Tools 

In  addition  to  (TK.  V\P.  and  SCW  DKC^n.t   HSX  supports  other  network 
nianatjement  tools  to  perform  specific  functions: 

•  Console  carrier  requestor  (CCR) 

•  Host  Task  Loader  (HLD) 

•  Network  Dump  Analyzer  (NI)A) 

•  Network  Display  IVo^^ram  (\TD) 

•  (^Ieue  Manager  utility  (QrK) 

•  Trace  interpreter  task  (TKI) 

Kach  of  these  tools  is  introduced  briefly  in  the  following;  section-  and  i.  de- 
scribed in  detail  in  Chapters  7  through  i:^.  Krror  messages  associated  with 
these  utilities  are  described  in  Chapter  14. 

1.7.1  Console  Carrier  Requestor  (CCR) 

The  console  carrier  requestor  iCVH)  provides  remote  access  to  console  carrier 
services  on  a  remote  Di^ntal  Kthernet  Communication  Server  (DKCS)  system 
(  (  R  uses  the  DLX  interlace  to  communicate  with  the  console  carrier" server 
(CCS)  at  the  remote  node,  (^hapter  7  describes  how  to  run  CCR. 

1.7.2  Host  Task  Loader  (HLD) 

The  Host  Task  Loader  (HLD)  is  a  utility  that  enables  vou  to  down-line  load 
tasks  to  a  target  RSX-llS  system  that  is  running  DKCnet.  This  enable,  the 
target  system  to  use  a  host  node  for  storing  task  images  (both  overlaid  and 
nonoverla.d)  on  disk  and  tor  providing  disk  space  for  checkpointing  tasks 
C  hapter  4  describes  the  prerequisites  for  down-line  loading  tasks  (^hapter  8 
discusses  the  HLD  mapping  table  used  by  the  utilitv  to  handle  requests  from 
the  remote  (also  referred  to  as  satellite)  node. 

1.7.3  Network  Dump  Analyzer  (NDA) 

The  Network  Dump  Analyzer  (NDA)  is  a  DFO.et  utilitv  used  to  analvze 
crash  dumps  o(  RSX  systems  that  were  running  DKC^net  when  the  crash 
occurred.  NDA  is  a  nonprivileged  task  tor  use  onlv  on  DKCnet  RSX  (includ- 
ing those  .systems  with  a  PSI  capability).  NDA  uses  the  network  ..vmbol  table 
tile  to  compile  and  analyze  information  from  a  crashed  svstem  imacre  The 
utility  creates  both  a  formatted  file  Irom  the  dump  media  and  a  listing  print- 
out. NDA  is  useful  only  if  you  are  familiar  with  internal  data  structures  and 
data  bases  for  DKCnet-RSX  and  RSX   1 1  PSL 

Vou  cannot  use  NDA  to  analyze  a  crash  dump  unless  the  executive  crash 
dump  routine  has  been  built  into  the  RSX  operating  .svstem  during  svstem 
generation  (see  the  RSX  IIM  Sy.strm  Cenrratmn  and  Instnllatinn  (hndr) 
C  hapter  10  discu.sses  NDA  capabilities  and  provides  a  summarv  ..f  the  NDA 
command  .syntax  and  switches. 
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1.7.4  Network  Display  Program  (NTD) 

NTD  provides  real-time  displays  of  network  status  information  such  as  active 
network  tasks  and  resources  allocated  to  the  system  or  a  summary  of  reach- 
ahle  nodes.  The  display  information  changes  as  the  status  changes.  You  can 
run  NTD  to  display  resource  information  about  your  node,  anv  other  Phase  IV 
DECnet-RSX  node,  or  any  Phase  III  DECnet-ksX  or  DECnet-IAS  node  in 
the  network.  Chapter  II  describes  the  commands  used  to  manipulate  the 
NTD  displays  and  describes  the  display  formats. 

1.7.5  Queue  Manager  Utility  (QUE) 

The  Queue  Manager  utility  (QUE),  supported  by  RSX-llM  V4.()  and 
RSX-llM-PLl'S  V2.0,  provides  the  interface  to  the  DECnet  file  transfer 
queue.  (The  Ql'E  utility  itself  is  also  a  feature  of  the  RSX  operating  system.) 
You  use  Ql'E.  a  privileged  utility,  to  initialize  the  File  Transfer  Spooler 
(FTS)  queue  and  proce.ssor  and  to  manipulate  user-queued  FTS  requests. 
Chapter  12  describes,  how  to  use  QUE. 

1.7.6  Trace  Interpreter  Tasl(  (TRI) 

The  trace  interpreter  task  (TRI)  is  an  RSX- 11  PSI  facility  that  allows  you  to 
diagnose  software  problems  on  an  X.25  communications  line.  You  can  trace 
line  messages  and  write  them  to  a  file.  Use  TRI  to  analyze  and  print  informa- 
tion in  this  file.  TRI  is  useful  (mly  if  you  are  familiar  with  the  X.25  level  2  and 
■^  protocols.  Chapter  1.'^  provides  a  summary  of  the  TRI  command  syntax  and 
switches. 
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Chapter  2 

Network  Management  Components 


I  his  chapter  ..uthnes  DKCru'l  HSX  network  management  component,  and 
refers  y..u  t..  rehated  CFK.  NTP.  and  VNP  command.,  and  parameters  that 
you  can  use  to  conli^'ure  your  >ystem.  It  is  assume(i  that  vou  are  tamihar  with 
the  characteristics  ol  DKCnet  as  descrihed  in  the  Immdurtmn  tn  DhCnrt  and 
the  nuTLU'u  of  DECnrt  RSX. 

The  components  descrihed  in  this  chapter  can  he  modilied  m  three  ditlerent 
data  hases.  depending:  on  the  network  management  utilitv  command  that  is 
used,  as  outhned  below: 


Command  Function 

<  rt'att's  modilies  pariinu-rtT^ 
('lear>  p.irarm'ler^ 
Displavo  tMmpunent  data 


CFE 

(permanent 
data  base) 

DKKINF. 

ITHtiF. 

LIST 


NCP 
(volatile 
data  bise) 

SKT 

CI.  HAH 

SHOW 


VNP 
(system 
image  file) 

SKT 

(  I.KAH 

SHOW 


There  is  a  common  set  o(  commands  and  parameters  that  applv  to  all  DKCnet 
systems.  In  addition,  each  DKCnet  s>stem  has  commands  and  parameters 
that  are  specific  to  it;  tor  example.  DKCnet   HSX  has  svstem-specific  com- 

ryL'^^V'  >^''^^"''  ''^'''''^'"  "^'''''''-  '^"'^  processes.  .Appendix  A  summarizes  all 
(  Fh.  N(  \\  and  \  NP  commands  and  uses  red  ink  to  identilv  those  that  are 
RSX  system  specific. 

The  components  that  are  covered  in  ihi>  chapter  are  listed  below  with  refer- 
ences to  the  sections  in  which  they  are  discu.ssed.  Where  applicable  descrip- 
tions include  the  component  ID  format,  a  table  of  the  network  management 
utility  parameters  a.s.sociated  with  the  component  -unl  anv  other  inf<.rmation 
that  IS  u.setul  in  configuring'  the  component  within  the  network. 
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Component 


Section 


tiiuUuh-*  ,n  ( «•>>  i  (lilt  nil.  aliases. 
Ktln-riut  .i(i(ir«'>«>mj:i 

Kniiiiiit: 

i.mt's 
('ir(Uit> 

('oiintt'rs 

Processes 

I'SI  iiindiilf. 
\  _''i  pnitmiil  rn<»(iule 
\  _'•">  *er\er  niixiule 
\  _'M  -»r\fr  niiiHiilr 
\  _'"'  ,i(  I  «'s«  module 


Sertion  2. 1 

Sect  Kill  _'.:.' 
S»'(titi[i  Jit 
Sec  til  in  2  4 
Sf(  t Hill  l!  .') 
Set  til  1(1  _'.») 
Sect  mil  _'  7 
Sett  lull  J  > 
Secti.m  J  M 


Systfiii  iiirnpciU'iit  pararm-tcrs  tor  nctwrk  hiitU-rs  arc  (iisctisscfl  in  Chapter."). 


2.1    Nodes 


.\(>(lf>  art'  Diizital  sysletn>  ihat  run  DKCnet  xiltwarc  that  provides  the  inter- 
face hetween  the  local  operatinii  >vstcni  and  the  network. 

Three  terms  are  applied  to  nodes,   retlectm^  your  relationship  to  the  node 
beinj:  described: 

•  Local  node.  Your  node        the  node  troni  which  you  operate. 

•  Remote  node.  Any  node  other  than  vours  in  the  network. 

•  Executor  node.  'I'he  node  at  which  'our  current  network  nianaKenient 
command  executes.  Isually  the  execut<»r  is  the  local  node.  However,  you 
can  execute  most  NCP  commands  at  a  remote  node,  as  described  in  Chap- 
ter ♦  ;.  In  such  a  case,  vour  local  node  would  be  considered  a  remote  node  bv 
the  executor. 

Manv  functions  that  the  system  mana^^er  pertortns  require  the  identification 
«>t  a  specific  no(ie.  For  example,  vou  can  use  a  remote  node  name  with  the 
.Network  Displav  Program  i.\'I"I)»  to  displav  active  network  intormation  f.,r 
that  nodv.  During  network  generation.  V(.u  detme  \our  node's  name  and  ad 
dress  as  the  executor  node,  ^^.u  lan  also  define  node  names  and  addresses  tor 
remote  nodes.  The  information  that  vou  define  f(.r  the  executor  is  used  in  the 
operation  of  DKCnet  at  that  node. 

When  vou  confiLMire  a  network  at  the  local  node  vou  must  have  node  name 
and  address  entries  m  the  \olatile  data  base  for  the  local  node  and  for  all 
nodes  with  which  vou  ma\  want  t(.  establish  a  logical  link.  'I'he  following 
sections  describe  node  identification  and  the  rele\ant  node  parameters  for 
estabhshing  an  operati<»nal  network  node  data  base. 
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2.1.1    Node  Identifier      n 

A  iii«(i(.  ID  (■iu^  !)»'  spfcitit'd  in  twn  fornis: 

•  Node  address.  A  uukjiu-  mtcLTr  m  the  rani:*'  «•(  1  tc  l(i'j;{. 

•  Node   name.   A   -ini(|iu'  Mlphanunicnc  diarain-r  >iMri-  toniamm-    1    in  ♦, 
charatUTv  imludiii^'  al   lca>l    1  alphahct u-  i  haraiti-r. 

Tn  satiMv  n.utinc;  reijuirenu-Ml>.  t-ach  n.-dc  in  the  network  nui>t  have  a  uni(|ui. 
iH.dr('».  whuh  i«.  defined  at  neiwnrk  -enerati.m.  Kach  n.xle  niii>t  aUn  have  a 
uni.jue  name  a»(.eiated  with  it>  ad(lre>>  m  ..rcler  t.-r  a  Inmcal  lini-  to  be 
e>tal>li.shed  with  it  It  n<.  n.-de  name  ha>  l.een  a.>.Hiated  with  a  node  a(idre>s 
■M  network  ^'eneraiion.  you  ran  do  «...  later  iism^  a  SKTDKKINK  XODK 
eommand.  Note  that  the  node  name  i>  known  onlv  to  the  local  node'netuork 
software,  while  the  node  ad(ire>>  i>  kn.-wn  ndworkwide  hv  the  nuitin-  tune- 
tion. 

Once  vou  have  SHntied  h.ith  a  nodr  name  and  a  node  ad(h-e».  v-ui  can  u>e 
either  one  wherever  voi,  need  to  .pccitv  a  node  ID  m  CKK  \(|'  md  \\|» 
eommand...  The  local  DKCnet  H.s\  >o|,ware  tran.late>  node  nameV.nto  node 
a(idre>.>e>. 

To  .implilv  rem..te  node  ident ifivation.  voc  can  a-iun  alia>  n.ule  name>  (..ee 
jVclion  :.'.].  l.Ji  to  destination  nodes.  Alia,-  node  name^  are  known  onlv  t.i  the 
local  node.  I  he  network  -.ttware  map>  alia>  node  name.,  to  the  network 
de-tinalion  nocie  name  and  addre..... 

When  v..i;  wi,.h  to  execute  a  network  management  eommand  lor  t  he  executor 
node,  vou  can  often  u>e  the  kevw.rd  KXHCTTOH  lahhreviated  to  K\Fi  as  a 
short  cut  to  >pecilvin^  .\()I)K  runir-id.  For  example,  if  vou  were  executing 
command.,  on  node  HO.STO.X.  the  following'  two  c,,mmand>  would  result  in 
the  same  display: 


• 


NCP  5-*G^  NODE  5DST0N 
NCP  SHQw  E:;E 


-'  remove  the  ass<.ciati()n  of  a  node  name  with  a  node  address  m  the  volatile 
data  ha.se.  u.se  the  CLKAH  XODK  XAMK  n.mmand.  Thereafter,  vour  nudv 
will  not  reco-ni/e  that  node  name  and  can  no  lon^^er  establish  logical  links  k, 
that  node.  To  remove  a  node  from  the  permanent  data  hi.se.  vou  must  use  the 
PI  H(;K  XODK  ALL  command. 

The  PrH(;K.  LLSr.  and  SHOW  XODK  commands  allow  vou  to  specifv  a 
command  for  all  known  nodes,  instead  of  for  just  one  specific  node.  The 
KXOWX  XODK.S  keyword  refers  to  all  nodes  that  have  been  defined  in  the 
permanent  data  base  <and  -  for  .SHOW  KXOWX  XODKS  in  the  volatile 
data  ba.se).  The  SHOW  XODK  command  also  allows  other  m<.re  restricted 
plural  specifications  for  nodes  isee  the  discussicm  of  SHOW  commands  in 
(  hapfer  A). 
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Loop  nodes.  A  loop  node  is  a  special  node  that  desijjnates  a  loop  path 
without  regard  for  standard  network  routing  procedures.  A  loop  node  name  is 
associated  with  a  specific  circuit  coming  from  the  executor  node.  Loop  nodes 
are  used  primarily  for  testing  network  hardware  (see  the  LOOP  commands  in 
Chapter  6). 


2.1.1.1  Access  Control  —  Certain  NC"  commands  require  you  to  specify 
access  control  information  with  the  node  ID  when  you  are  attempting  to 
access  a  remote  node.  This  section  describes  the  access  control  format  and 
briefly  describes  how  to  set  up  default  access  control  information  using  alias 
node  names. 

The  system  manager  can  control  user  access  to  the  local  system  at  the  node  or 
object  level  for  inbound  logical  link  connections.  Incoming  call  handling  for 
access  to  local  DTE  and  PSI  objects  is  regulated  differently  (see  the  RSX-11 
PS!  System  Manager's  Chiide). 

Access  control  information  can  be  supplied  in  either  of  two  formats:  the 
standard  DECnet  format  or  an  R8X-specific  format. 

Standard  DECnet  format: 

node-id        [USER  user-id] 

[PASSWORD  passuord] 
[ACCOVST  account] 

RSX-specific  format: 

n()de-id[/user-id[/password[/account]]] 
where 


node-id 


user- id 


passuord 


account 


is  the  node  name  or  address  of  the  node  to  be  accessed  (see  Sec- 
tion 2. LI). 

is  a  string  of  up  to  16  characters  that  is  the  user's  log-in  identifica- 
tion to  be  verified  by  the  destination  node.  The  log-in  identifica- 
tion for  RSX  can  be  the  account  name  or  the  account  number.  An 
account  number  can  be  specified  in  two  ways:  with  brackets  or 
without  brackets.  For  example,  the  same  account  number  could 
be  expressed  as  [1(X).3]  or  100.3. 

is  a  string  of  up  to  8  characters  to  be  verified  against  the  destina- 
tion node's  system  account  file. 

is  a  string  of  up  to  16  characters  that  supplies  additional  account- 
ing information  for  the  destination  node.  This  field  is  ignored  by 
RSX  nodes. 


If  any  string  contains  a  blank  character  or  tab.  enclose  the  string  with  quota- 
tion marks  C'strin^'').  If  you  want  to  use  a  quotation  mark  within  a  quoted 
string,  use  double  quotation  marks  ("  "i  to  distinguish  it  from  a  string  delim- 
iter. 
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NOTE 

If  you  do  not  want  a  password  echoed  to  your  terminal  as  you 
enter  an  \CP  command,  enter  a  carriage  return  after  the  key- 
word PASSWORD.  XCP  prompts  for  the  password  and  turns 
ott  echoing  until  the  next  time  it  prompts. 

2.1.1.2  Alias  Node  Names  -  One  way  to  simplify  the  process  of  specifying 
access  control  is  to  set  up  alias  node  names  that  include  access  control  infor- 
mation Alias  node  names  are  pseudonames  that  vou  can  use  in  place  of  a 
node  ID  whenever  you  identify  a  DECnet  node  in  the  network.  Aliases  can 
also  be  used  by  other  DECnet  programs  and  utilities  (for  example,  XFT). 

You  can  create,  modify,  display,  and  clear  alias  node  names  in  the  volatile 

cuf.n^?/l"A'"  ^^^  '•'■'^^"'  '""^^^  ^''^  ^'>'  "^^i"^  ^he  NCPA'XP  SET  ALIAS 
SHO  \  ALIAS,  and  CLEAR  ALIAS  commands  (see  Chapter  6  for  complete 
details).  The  following  example  shows  how  to  set  an  alias  node  name: 

NCP.SET  ALIAS  -.A;:  DESTINATION  CH  I  /  [  1  ,  i]  .  rjECNE  T  TERMINAL  TTll: 

This  comniand  equates  the  alias  name  VAX  with  node  CHI.  Once  this  c(»m- 
mand  has  been  executed,  the  alias  name  VAX  can  be  used  in  XCP  commands 
where  >.,u  would  normally  have  to  specify  CHI  and  its  access  control  informa- 
tion. The  above  command  specifies  that  the  alias  is  valid  on  operations  initi- 
ated trom  terminal  TTll:.  Therefore,  all  logical  link  connect  requests  from 
progranis  associated  with  terminal  TTll:  to  node  VAX  are  transmitted  to 
n(.de  CHI.  Sin  ilarly,  an  XCP>SHOW  XODE  VAX  command  will  displav 
data  for  node  CHI. 

Privileged  users  can  specify  alia.ses  for  a  global  scope  -  that  is.  for  all  termi- 
nals on  the  local  node.  Xonprivileged  users  can  set  aliases  onlv  for  their  own 
terminals  (default).  Any  alias  must  be  unique  within  its  scope.  Alias  names 
are  known  only  to  your  local  node.  DECnet-RSX  software  handles  the  trans- 
lation from  alias  to  node  name. 

DECnet-RSX  automatically  defines  a  blank  alias  node  name  for  all  network 
users.  Connects  to  a  blank  node  name  default  to  the  local  node  You  can 
change  this  association  by  setting  a  destination  node  for  the  blank  alias  -  for 
example, 


NCP  SET  ALIAS 


DESTINATION  CHI 


The  blank  node  name  is  useful  for  debugging  network  programs  locally. 
2.1.2   Specifying  Access  Control  Verification 

You  can  control  inbound  access  to  your  node  on  two  levels:  the  node  level  and 
the  object  level.  You  can  specify  that  access  control  be  verified  t  vour  node 
on  all  incoming  connect  requests  to  DECnet  objects.  In  fact,  node  level  access 
control  verification  is  required  on  systems  that  support  multiuser  protection 
io  assure  access  control  verification,  you  must  set  VERIFICATIOX  parame- 
ters to  OX  at  both  the  executor  and  the  object  level. 
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You  can  use  CFE.  XCP,  and  VNP  commands  u  modify  access  control  on  both 
the  node  and  the  object  level.  If  vou  set  the  VERIFICATION  parameter  to 
OFF  in  a  SF:T/T)EFI\E  EXECITOR  command,  the  executor  overrides  the 
verification  options  set  for  individual  objects  and  allows  access  to  all  objects. 
When  verificati(m  at  the  executor  level  is  set  to  OX.  verification  states  speci- 
fied for  individual  objects  are  used  (see  the  DEFIXE/SET  OBJECT  com- 
mand descriptions  in  Chapter  6). 

CAUTION 

If  access  control  verification  is  turned  off,  anyone  can  access 
vour  svstem. 


2.1.3    Node  Parameters 

The  permanent  data  base  must  contain  certain  information  about  the  local 
node.  Optionally,  it  can  c(mtain  information  for  all  nodes  with  which  you  wish 
to  communicate.  You  can  specify  names,  access  ccmtrol  information,  node 
type,  and  node  counter  information  for  any  or  all  of  the  nodes.  If  a  remote 
node  can  be  down-line  loaded,  you  can  specify  a  number  of  default  parameters 
to  be  used  locally  to  perform  a  down-line  load  operation.  Table  2-1  lists  all 
node  parameters  by  function  and  groups  them  according  to  the  kind  of  node  t.) 
which  they  apply. 

^ou  can  modify  and  display  node  parameters  by  using  the  following  com- 
mands (which  are  described  with  their  parameters  in  Chapter  6): 


CFE  Commands 

DKFINK  KXECITOR 
DKKINK  NODK 

PIRGE  NODE 
LIST  EXKriTOH 
LIST  NODE 


NCPA/NP  Commands 

SP:T  EXEriTOH 

sp:t  node 
cle.ar  execttor 
cle.ar  node 
show  execitor 
show  node 


2.1 .3.1  Executor  Node  Identification  String  —  During  network  generation,  you 
can  provide  a  string  of  information  that  is  displayed  whenever  you  display 
executor  node  information.  To  modify  this  string,  use  the  IDEXTIFICATIOX 
parameter  with  the  DEFIXE  EXECITOR  command.  If  the  string  you  specify 
contains  space  or  tab  characters,  you  must  delimit  the  string  with  quotation 
marks.  If  you  want  to  include  a  quoted  string  within  a  displayed  string,  use 
double  quotations  around  the  quoted  string  to  distinguish  it  from  the  string's 
end  delimiter.  When  the  message  is  displayed,  the  system  will  discard  one  set 
of  quotation  marks. 

Example: 

CFE  DEFINE  EXECUTOR  IDENTIFICATION  "DECnet  RS);  "  "  BOS  "  " '.'^  .  0  " 
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Table  2-1:    Node  Parameters  and  Their  Functions 


Function 

Node  identification 

Local  node  state 
Access  control 

Logical  link  control 


Routinfj  control  (2) 


Routing  initialization 
passwords  (2i 

Loop  node 
identification 

Down-line  loading  i.'i) 


I'p-Iine  dumping  (3) 


incoming     PSI 
control 


Executor  Node 

ADDRESS 

NAMK 

IDENTIFICATION 

STATE  (ON/OFF/SHIT) 

VERIFICATION  STATE 
(OFF/ON) 

MAXIMUM  LINKS 
MAXIMl'M  NODE 

COCNTERS 
SEGMENT  BIFFER  SIZE  1 1) 

MAXIMUM  ADDRESS 
MAXIMUM  COST 
MAXIMUM  HOPS 
MAXIMUM  BROADCAST 

ROUTERS 
MAXIMUM  BROADCAST 

NONROUTERS 
ROUTIN(;  TIMER 
BROADCAST  ROUTINC; 

TIMER 

TRANSMIT  PASSWORD 
RECEIVE  PASSWORD 


Remote  Node 

ADDRESS 
NAME 


CIRCUIT 

DIACJNOSTIC  FILE 
HARDWARE  ADDRESS 
HOST 
LOAD  FILE 

SECONDARY  LOADER 
SERVICE  CIRCUIT 
SERVICE  DEVICE 
SERVICE  NODE  VERSION 

(PHASE  IIIT'HASE  IV) 
SERVICE  PASSWORD 
TERTIARY  LOADER 

DUMP  ADDRESS 
DUMP  COUNT 
DUMP  FILE 
HARDWARE  ADDRESS 


call       SUBADDRESSES  rannv 


1.  See  Chapter  5  for  more  mformation  on  specifying  system  buffers. 

2.  See  Section  2.2  for  a  discussion  of  routing  and  routing  parameters. 

•'l    See  Chapter  4  for  information  on  down-line  loading  and  up-line  dumping. 
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2.1.3.2  Executor  Node  Subaddresses  —  During  network  generation,  you  can 
define  a  range  of  subaddresses  for  the  executor  node  to  use  for  DLM  opera- 
tions. The  executor  node  accepts  incoming  DLM  calls  that  have  a  subaddress 
that  falls  within  the  specified  range. 

Use  the  STBADDRESSES  parameter  to  modify  the  executor  subaddresses  in 
any  of  the  three  data  bases.  A  subaddre.ss  can  be  a  single  number  or  a  range  of 
numbers  in  the  range  of  0  to  9999.  When  specifying  a  range,  .separate  the  two 
subaddre.vses  that  delimit  the  range  with  a  hyphen,  always  listing  the  smaller 
number  first. 

Example: 


NCP  5ET  EKECUTOR  SUBADDRESSES  a2-50 


This  command  specifies  the  executor  node  to  handle  all  incoming  PSI  calls 
that  specify  a  local  DTK  subaddress  in  the  range  of  42  to  '>().  All  other  calls 
will  be  handled  by  PSI. 

2.1.4    Node  Counters 

DK('net  software  automatically  collects  certain  statistics,  called  counters,  for 
nodes  in  the  network.  Such  information  can  include  the  number  of  connects 
sent  and  received,  the  number  of  messages  sent  and  received,  and  the  number 
of  messages  retransmitted. 

If  a  logical  link  is  established  to  a  new  node  after  all  node  counters  have  been 
used,  the  least  recently  used  counter  block  is  reassigned  to  the  new  node,  and 
the  counters  for  the  old  node  are  displayed  in  an  event  message. 

For  more  information  on  using  counters,  see  Section  2.7.  For  a  complete 
listing  of  node  counters,  see  Appendix  E. 


2.1.5   Ethernet  Address  of  Node 

Nodes  on  Ethernet  lines  are  identified  by  unique  Ethernet  addresses.  A  mes- 
sage can  be  sent  to  one.  several,  or  all  nodes  on  an  Ethernet  line  simultane- 
ously, depending  on  the  type  of  Ethernet  address  used.  You  do  not  normally 
have  to  specify  the  Ethernet  address  of  an  individual  node  in  order  to  config- 
ure your  network;  the  software  at  the  node  sets  its  own  E^thernet  address.  You 
need  to  know  the  Ethernet  address  of  a  node  for  service  functions  (such  as 
down-line  load  or  circuit  loopback  test)  but  not  for  normal  network  opera- 
tions. 


2.1.5.1    Format  of  Ethernet  Addresses  —   Ethernet  addresses  are  represented 
as   six    pairs  of   hexadecimal   digits   separated    bv   hvphens   (for   example 
AA-()l-23-45-67-FF). 
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Xerox  (  orporation  assigns  a  hh.ck  ot  addresses  to  a  producer  ..f  Kthernet 
inlertaces  up..n  applirali<.n.  Thus  every  manutaeturer  has  a  unique  set  o| 
addresses  to  use.  Normally,  one  address  out  ot  the  assigned  block  (.1  phvsicai 
addresses  is  permanently  associated  with  each  interface  (usuallv  in  a  "read- 
only memory).  This  address  is  known  as  the  Ethernet  hardware  address  of 
the  mtertace. 


NOTE 

You  can  use  the  \(T>  SHOW  IJNK  Imr-id  rHAHACTFJilS- 
WrS  command  to  display  the  hardware  addre.ss.  See  the  ex- 
ample in  Chapter  '{. 

I)isitar>  interface  to  Kthernet  ithe  DKIWA  or  DKC^NA  controller  at  the 
node)  has  the  ahilitv  to  .set  a  ditterent  logical  addre.s.s  to  f)e  used  by  the 
uitertace:  this  address  is  known  as  the  Ethernet  physical  address  When  a 
node  on  the  Kthernet  initially  starts  up.  the  physical  addre.ss  is  the  same  as 
the  Kthernet  hardware  address.  Then  when  DKCnet  turns  on  an  TN  A  or  (X\A 
device  the  DKIAA  or  I)K(^\A  controller  con.structs  a  physical  address' 1,'v 
appenc  incj  the  local  node's  4-diKit  -KKJe  address  to  a  constant  S-di^it  number 
derived  (rom  the  block  addres.ses  u.ssigned  to  I)ic,Mtal  (AA  iM)  ()-}  ooi. 

Once  the  Kthernet  physical  address  has  been  set  to  its  new  value,  it  is  reset  t.. 
Its  original  hardware  address  value  onlv  when  a  reset  is  issued  to  the  OKINA 
or  DKl^NA  (lor  example,  when  the  machine  power  is  shut  oil). 

2.1.5.2  Ethernet  Multicast  Address  Types  -  Kthernet  physical  addres.ses  (de- 
scribed ab..ve.  and  Kthernet  multicast  addresses  (described  beh-w)  are  distin- 
guished by  the  the  value  ..1  the  leading  h.w-order  bit  ol  the  lirst  bvte  ol  the 
address: 

•  Physical  address.  The  unique  address  ol  a  sin-Ie  node  on  anv  Kthernet 
•  low-order  bit       (i). 

•  Multicast  address.  A  multidestination  addres.s  ol  one  or  more  nodes  ..n  a 
^iven  Kthernet  ( low-order  bit       1). 

There  are  two  types  of  multicast  address: 

•  A  rnulticast  group  address  is  an  address  that  is  assigned  to  anv  number  ol 
node  KH.ups  so  that  thev  are  all  able  to  receive  the  same  message  in  a  snude 
transmission  by  a  .sending  node. 

•  tv  ^uTvvT.  .^1?"  "^  '  ^"^^'^'  n^ulu.ns^  address  (specilicallv. 
n  }-}■  hV  V\-  n  FP)  to  which  a  message  can  be  sent  il  ,t  must  be 
received  by  all  nodes  (,n  a  given  Kthernet.  ( Ise  a  broadcast  addres.s  nnlv  lor 
mes.sages  to  be  acted  up..n  by  all  n.KJes  on  the  Kthernet.  since  all  nodes 
must  process  them.) 
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2.1.5.3  Ethernet  Physical  and  Multicast  Address  Values  —  I)ij,MtaI  physical 
addresM'^  art' in  the  raii^t' AA  (Ki  (Hi  (Mi  ini  (MithnniL'h  \.\  (M)  dl  VV  W  KF. 
Multicast  addresses  assigned  (..r  use  iii  iross-toinjKniy  tonHuunicalicus  arc: 

Value  Meaning 

yV  VV  VV  VV  VV  VV  Bn-adcaM 

*'f-    '•"  ""'  ""  '•"  "<'  I.o..i>l)iuk  a>MMatur 

Digital  multicast  ad(ir:'s>es  as.sii,rned  to  he  received  hy  other  Dij^ital  nodes  on 
the  >anie  Kthernet  are: 

Value  Meaning 

AH    'H.   (Ml   (II    IN)   INI  I),   .„,,  l,„(j   ...HMalUf 

Ah  (HI  (Ni  (ij  (HI  (N»  Kfniofi.  n.n.soie 

.AH  (HI  (Ni  (i.{  (N)  (Ml  All  I'h.iM   I\-  r.H,t.-r> 

AH  (KI  (K)  (14  (HI  (Ml  All  Phase  \\   end  node-. 

AH  (HI  ,Ni  .1.-,  (Ml  (NI  Hfsorved  tnr  nmire  a^e 

through 
AH  tH.  (.}  VV  VV  VV 

DKCnet  aKvav>  >el>  up  thv  DKINA  nr  DKC^XA  at  each  node  to  receive 
messages  .sent  toanv  address  in  theah..\e  li>t  ol  Digital  nuilticast  addresses. 


2.2    Routing 


Routing  is  the  network  function  that  determines  the  path  or  route  along  which 
data  (called  packets  in  this  context)  travels  trom  its  source  to  its  destination. 
Routing  is  performed  transparently  hy  the  Transport  layer  of  DKCnet  soft- 
ware. As  system  manager,  however,  you  must  be  concerned  with  the  configu- 
ration of  the  network  into  routing  and  nonrouting  nodes  and  with  a  set  of 
parameters  that  provides  a  degree  of  indirect  control  over  network  routing. 
This  .section  explains  the  different  types  of  routmg  and  nonrouting  nodes  and 
then  describes  the  routing  parameters  you  can  control.  The  Intrnductmn  to 
DKCnet  and  the  Ovvrvinr  n{  DECnrtRSX  provide  more  detailed  informa- 
tion about  routing  concepts  and  mechanisms. 

2.2.1    Types  of  Nodes 

A  Phase  IV  DECnet-RSX  node  can  be  either  a  routing  node  or  an  end  node. 
Either  type  of  node  can  be  connected  to  a  r)r)C\n\  PCL.  Kthernet.  or  DLM 
circuit.  All  Phase  IV  nodes  can  communicate  with  one  another  and  with  Phase 
III  nodes.  Phast  IV  nodes,  however,  cannot  communicate  with  Phase  II  nodes. 

Routing  nodes  have  a  route-through  capability  and  are  able  to  support  mul- 
tiple circuits.  They  maintain  routing  data  bases  that  allow  them  to  route  their 
own  transmit  packets  as  well  as  packets  received  from  other  nodes.  On  an 
Ethernet,  a  single  routing  node  called  the  designated  router  (see  Section  2.5.9) 
performs  routing  functions  for  all  of  the  nodes  on  the  Ethernet. 
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End  nodes  support  only  one  circuit  and  do  not  maintain  a  routing  data  base. 
An  end  node  can  establish  logical  links  to  any  node  in  the  network,  but  it  can 
send  packets  to  and  receive  packets  from  the  adjacent  node  only.  Because  all 
nodes  on  an  Ethernet  are  considered  to  be  adjacent  to  each  other,  an  Ethernet 
end  node  can  communicate  directly  with  more  than  one  node.  End  nodes 
connected  via  a  DDCMP.  PCL.  or  DLM  circuit,  however,  are  adjacent  to  a 
single  node  only. 

2.2.2    Routing  Parameters 

Some  parameters  that  affect  routing  are  defined  for  the  executor  node  compo- 
nent, while  others  are  defined  for  the  circuit  component.  Table  2-2  lists  the 
parameters  by  component  and  specifies  the  utilities  that  can  modify  them. 
Parameters  that  apply  to  Ethernet  nodes  only  are  listed  separately.  The  net- 
work generation  procedure  sets  default  values  for  all  of  these  parameters. 

Table  2-2:    Routing  Parameters 


CFE       NCP/VNP 


Component        Parameter 
General  routing  parameters: 

EXECITOR       M.WIMIM  ADDRKS.S 
M.AXIMIM  COST 
MAXIMIM  MORS 

ROITINC;  TI.MKK 
riR(niT  ro.ST 

HP:LL0  TIMER 
Ethernet-only  parameters: 

EXECITOR        RRO.ADC.AST  ROITI.VC.  TIMER 

MAXIMIM  BROADCAST  NO.NROITERS 

CIRCITT  .MAXIMIM  BROADCAST  ROITERS 

ROUTER  PRIORITY  (described  in  .Section  2.5.9) 


2.2.2.1  Maximum  Node  Address  —  During  network  generation,  vou  specify 
the  highest  node  address  to  be  allowed  in  the  network.  This  controls  the  size  of 
routing  configuration  messages  exchanged  between  nodes  and  determines  the 
size  of  the  internal  routing  data  base  constructed  by  the  network  .software. 
Vou  can  modify  this  value  in  the  permanent  data  base  using  the  MAXIMl'M 
ADDRESS  parameter.  To  obtain  the  most  efficient  routing  operation,  sequen- 
tially number  your  nodes  from  1  to  n.  where  ^7  is  the  highest  node  address. 

2.2.2.2  HELLO  TIMER  Parameter  -  The  DECnet  Transport  laver  software 
sends  hello  messages  over  DECnet  circuits  at  regular  intervals  and  wait^  for  a 
response  to  determine  if  the  circuit  is  still  operative.  If  the  circuit  i.;  inactive, 
the  Transport  layer  attempts  to  reinitialize  it.  Vou  can  we  ihe  HELLO 
TIMER  parameter  to  modify  the  frequencv  with  which  messages  are 
transmitted. 


X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 
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Figure  2-1:    Circuit  and  Path  Cost  Reiationship 
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2.2.2.3  circuit  Cost  -  During  network  generation,  a  cost  is  automatically 
assigned  to  each  circuit  connecting  the  local  node  with  an  adjacent  node 
Ufc^Cnet  software  uses  circuit  cost  values  to  determine  the  path  over  which 
data  IS  transmitted.  You  can  use  the  COST  parameter  to  change  th  ^  cost  of  a 
circuit  Altering  circuit  costs  can  change  packet-routing  paths  and  thereby 
attect  the  use  and  availability  of  network  circuits  and  resources. 

l-se  the  following  guidelines  when  first  assigning  circuit  costs;  you  can  adjust 
these  values  later  if  doing  so  will  improve  performance. 

Ethernet  circuits  3 

Line  speeds  of  9600  or  less  5 

Line  speeds  over  9600  7 

DLiM  circuits  15 

Figure  2-1  illustrates  the  relationship  between  circuit  and  path  costs. 

2  2.2.4  MAXIMUM  COST  and  MAXIMUM  HOPS  Parameters  -  You  can  alter 
the  values  set  for  the  MAXIMUM  COST  and  MAXIMUM  HOPS  parame- 
ters, which  determine  the  reachability  of  nodes  in  the  network. 

The  maxim™  cost  parameter  specifies  the  maximum  total  path  cost 
allowed  from  the  executor  node  to  any  other  network  node.  A  remote  node  is 
unreachable  If  the  cost  to  get  to  the  remote  node  exceeds  the  value  set  for  this 
parameter.  Lse  as  small  a  number  as  possible  in  the  range  of  1  to  1022. 

The  MAXIMUM  HOPS  parameter  .specifies  the  maximum  number  of  hops 
allowed  trom  the  executor  to  any  other  node  in  the  network.  The  largest  value 
for  this  parameter  in  a  DECnet  network  defines  the  DECnet  network  diame- 
ter. A  remote  node  is  unreachable  if  the  number  of  hops  required  to  reach  it 
exceeds  the  value  set  for  this  parameter.  Use  as  small  a  number  as  possible  in 
the  range  of  1  to  30. 

2.2.2.5  Routing  Timers  -  DECnet-RSX  provides  a  timing  mechanism  that 
causes  circuit,  line,  and  node  configuration  changes  and  routing  configuration 
messages  to  be  transmitted  to  all  adjacent  nodes  from  the  local  node  Routing 
configuration  messages  provide  dynamic  network  configuration  information 
hat  can  affect  data  packet  routing.  For  example,  if  a  network  user  changes 
the  state  of  a  circuit  and  thereby  renders  a  remote  node  unreachable  this 
change  is  reflected  automatically  in  the  routing  configuration  data  transmit- 
ted to  adjacent  nodes. 

On  non-Ethernet  nodes,  you  use  the  ROUTING  TIMER  parameter  to  .set  a 
timer  who.se  expiration  forces  a  routing  update  regardless  of  whether  the  net- 
work configuration  has  altered. 
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For  a  node  on  an  Ethernet  circuit,  the  timing;  mechanism  is  called  a  broadcast 
routing  timer.  When  the  timer  expires,  the  local  node  sends  a  multicast  rout- 
ing configuration  message  to  all  nodes  on  the  Ethernet  (since  all  nodes  are 
considered  to  be  adjacent).  You  can  use  the  BROADCAST  ROUTING 
TIMER  parameter  to  specify  the  frequency  at  which  these  messages  are 
transmitted.  This  timer  is  usually  set  to  a  much  lower  value  (approximately 
:^0  to  40  seconds)  than  the  routing  timer  for  a  node  on  a  non-Ethernet  circuit 
(which  is  set  for  every  few  minutes).  Ethernet  routing  messages  are  .«ent  more 
often,  so  that  full  routing  messages  can  be  exchanged  in  case  of  datagram  loss. 


2.3    Objects 


An  object  is  a  DECnet  user  task  or  module  that  can  communicate  with  an- 
other such  task  or  module  over  a  logical  link.  All  objects  are  identified  by  an 
object  type  code  of  either  0  or  an  integer  in  the  range  of  1  to  255,  depending  on 
the  kind  of  object. 

•  Named  objects  are  in.stalled  tasks  identified  by  any  valid  user-defined 
RSX  task  name  in  a  logical  link  connect  request.  All  named  objects  have  an 
object  type  code  of  0. 

•  Numbered  objects  are  installed  tasks  or  modules  (such  as  FAL  and  MCE) 
that  provide  network  services.  Each  numbered  object  is  identified  by  an 
object  type  code  in  the  range  of  1  to  255.  Each  type  code  always  represents 
the  same  function  within  a  network,  even  if  the  task  that  actually  performs 
the  function  has  a  different  name  from  node  to  node.  Numbers  in  the  range 
of  1  to  127  are  reserved  for  Digital's  use;  numbers  from  128  through  255  are 
available  for  customers.  Appendix  B  lists  all  DECnet-RSX  object  type 
codes. 

At  network  generation,  the  system  automatically  defines  objects  for  all  se- 
lected tasks.  Later,  you  can  use  the  DEFINE/SET  commands  to  create  or 
modify  a  task  or  object,  using  your  own  value  or  an  object  type  code  from 
Appendix  B  to  specify  the  object.  Parameters  that  you  can  specify  for  each 
type  of  object  are  summarized  in  Table  2-3. 

Table  2-3:    Object  Parameters 


Parameter 

Named  Objects 

Numbered  Objects 

COPIF.S 

X 

NAME 

X 

ISER 

X 

X 

VERIFIC.ATIO.N 

X 

X 

Since  all  named  objects  have  the  same  type  code  (0).  any  changes  that  you 
make  to  object  type  0  apply  to  all  named  objects  on  your  node.  For  program- 
ming information  on  named  objects  and  their  use  in  task-to-task  communica- 
tion, refer  to  the  DECnet-RSX  Programmer's  Refervnvv  Manual  and  the 
RSX-II  PS!  User's  (iuide. 
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In  this  manual,  you  will  find  descriptions  of  these  parameters  under  the 
tollowing  commands  in  Chapter  6: 


CFE  Commands 

DKFINK  OB.IK('T 
PlRCiK  OB-IKCT 
LIS'l'  OH-IKCT 


NCPA^NP  Commands 

SKT  OH.IKCT 
CLKAH  ()B.IK(n* 
SHOW  OBIFXn- 


2.3.1    Single  Copy  and  Multicopy  Objects 

I'se  the  COPIES  parameter  to  specify  the  numher  of  copies  of  a  task  that  can 
be  run  at  the  local  node  at  once.  Specify  SINGLK  for  one  copv  or  specify  a 
number  in  the  range  of  2  to  64  for  a  multicopy  obiect.  All  numbered  object 
types  can  have  multiple  copies. 

When  >r.,  specify  a  number,  each  incoming  request  is  .^ent  to  a  new  copv  of 
the  task.  I  hus.  each  copy  of  the  task  handles  one  incoming  connection  This  is 
referred  to  as  single-threaded  operation. 

When  you  specify  SINCJLE.  the  task  determines  the  number  of  simultaneous 
connections  it  can  have.  This  is  referred  to  as  multithreaded  operation. 

2.3.2  Object  Names 

When  you  install  a  task  as  a  numbered  object,  vou  can  use  the  NAME  param- 
eter to  ..pecify  any  task  name  that  is  valid  for  RSX.  When  a  numbered  object 
has  multiple  copies,  you  must  install  it  with  a  name  in  the  following  format- 
xxx^S\  where  .v.v.v  is  any  valid  .S-character  RSX  task  name.  If  the  task  name  is 
not  installed  as  such,  a  logical  link  connection  cannot  be  established. 

When  the  network  software  establishes  the  logical  link,  it  replaces  the  three 
dollar  signs  with  a  specific  number.  Vou  can  see  the  final  task  names  in  the 
MU  display  of  active  tasks  (see  Chapter  11). 

2.3.3  Object  UlCs 

Once  activated,  objects  run  under  a  particular  TIC.  You  can  use  the  USER 
parameter  to  specify  whether  the  object  runs  under  the  log-in  UIC  or  under 
the  default  I  IC  under  which  it  was  built  or  installed.  The  log-in  UIC  is  the 
user  ID  that  was  specified  in  the  access  control  information  provided  at  the 
time  of  the  connection.  If  a  log-in  UIC  is  not  provided,  the  object  runs  uifder 
the  default  I  IC. 

The  object's  access  control  verification  option  must  be  set  to  ON  or  INSPECT 
to  run  under  log-in  UICs.  If  the  object's  access  control  verification  option  is 
not  on.  the  object  runs  under  the  default  UIC.  See  Section  2.1.2  for  a  discus- 
sion of  object  verification  options  and  access  control. 
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2.4    Lines 


DKCnet  -RSX  supports  tour  types  of  lines:  I)I)(^MP.  PCL,  Kthernet.  and  PSl. 
A  I)I)(^MF^  line  provides  the  physical  point-to-point  or  multipoint  connection 
between  two  or  more  nodes;  PfL  and  Ethernet  lines  are  multiaccess  connec- 
tions between  two  or  more  nodes;  and  a  PSI  line  is  the  physical  link  between  a 
user's  data  terminal  equipment  (DTK)  and  a  packet -switching  network 
(PSN). 

•lust  as  you  must  establish  node  parameters,  you  must  also  establish  parame- 
ters tor  all  physical  lines  connected  to  the  local  node.  Thus  you  must  identity 
each  line  by  name  and  specify  information  that  directly  affects  the  line's 
operation. 


2.4.1    Lines  and  Line  Devices 

Table  2  4  lists  the  devices  that  operate  on  the  tour  tvpes  of  lines  supported  by 
DKCnet  RSX  (DD('MI\  VC\.,  Kthernet.  and  PSJ).  Kach  line  type  is  de- 
scribed in  the  tollowing  sections.  You  should  be  familiar  with  the  entire  range 
of  devices  and  their  impact  on  network  management.  For  additional  informa- 
tion on  these  line  devices,  refer  to  the  Trrryunnis  and  ('Dnirjiunicdtions  Hand- 
hooh. 


2.4.1.1  DDCMP  Line  Devices  —  Four  of  the  DDCMP  line  devices  listed  in 
Table  2  A  have  the  DDCNU'  microcode  contained  in  the  hardware  device: 
DMC  11.  DMH  r.  DMP  11.  and  DMV  11.  'The  other  DT)CMI>  devices  in 
I'able  2  4  have  a  software  DDCMP  process. 

'The  DMC  11  and  the  DMH  11  (which  operate  identically)  provide  a  point-to- 
point  connection  between  two  nodes.  Circuits,  the  actual  communications 
path.  o[)erate  over  the  line. 

The  DMP  11  and  the  DMV  11  can  be  point-to-point  multipoint  control,  or 
multipoint  tributary  line  devices.  'Therefore,  they  can  provide  a  multipoint 
coimection  between  more  than  two  nodes.  It  is  possible  to  connect  two  multi- 
point lines  to  the  same  node.  'I'he  node  can  then  serve  as  the  control  station 
tor  one  multipoint  line  and  as  a  tributary  for  another  muitijMtinl  line. 

2.4.1.2  PCL  Line  Devices—  The  l»CT  IIM  provides  point-to-point  connec- 
tions bv  means  ol  a  parallel  time  division  multiplexed  <TDMl  bus.  PCL  llB 
hardware  allocates  a  traction  of  available  bu>  bandwidth  to  each  siation. 

2.4.1.3  Ethernet  Line  Devices  —  'The  Kthernet  line  device  is  either  the  I  NA 
•  T  the  (^N.A.  whu  h  provides  a  physical  connection  between  two  or  more  nodes 
nn  the  same  Kthernet  cable.  'I'he  Kthernet  line  protocol  supports  up  to  \i)2'A 
nodes  on  the  same  line,  'The  Kthernet  circuit  operates  over  the  Kthernet  line. 

A  node  !^  connected  tc  the  Kthernet  !:ne  by  a  DKCNA  or  DKC^NA  communi- 
cations controller,  a  transceiver,  and  a  transieiver  cable  A  specific  node  on 
the  Kthernet  is  identified  bv  the  Kthernet  hardware  addres>  of  its  line  device; 
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Table  2-4:    Digital  Communications  Devices  Supported  by  DECnet-RSX 


Device 

Line  Type 

Multiline 

Mu 

1)1. 

DDCMP 

No 

Yes 

DI.V 

DDCMP 

No 

^e^ 

DMr 

DDCMP 

No 

No 

DMP 

DDCMP 

No 

Yes 

DMR 

DDCMP 

No 

No 

DMV 

DDCMP 

No 

Yes 

DF'V 

DDCMP 

No 

Yes 

\n 

DDCMP 

No 

Yes 

1)1  }' 

DDCMP 

No 

\-ev 

DIV 

DDCMP 

\(. 

>es 

I)V 

DDCMP 

Ve> 

Yes 

1)7. 

DI)CMF> 

^es 

^es 

I)/V 

DDCMP 

No 

Yes 

KDP 

DDCMP 

Ves 

Yes 

KDZ 

DDCMP 

Yes 

>es 

KMX 

PSI 

Yes 

\  A 

VC\. 

pri. 

N.) 

'Ves 

SDP 

PSI 

No 

N  A 

S[)V 

PSI 

N(. 

\  A 

INA 

Kfhernet 

N  A 

N  A 

C^NA 

K  the  met 

N  A 

N  .\ 

this   hardware  address   is  stored   in   read-onlv   mem..rv   in   the  l)FA\.\  or 

HL^ov^  ^^^"^^  ^^^^^'"'^  '^'''^'  ''"  Kthernel  line,  it  causes  the  DKIWA  or 
IJhC^NA  connected  to  the  line  to  construct  an  Kihernet  physical  address  inr 
the  node  (see  Section  L>.1..^.1).  The  IWASA  or  DKQNA  resets  the  phvsical 
address  to  the  original  hardware  address  if  the  device  is  reset  (for  example  il 
the  machine  power  is  shut  off). 

mufi  n^^'  '■'"^°,7^^«»  -  f^'^>^  11  l^'^I  •'^^'PPorts  three  line  devices:  the 
Dl  Pll-DA.  the  KMMl-HI).  and  the  KMSll-PX.  The  DrPll  DA  is  a  low 
speed  synchronous  interlace.  The  combination  ol  the  KMSll-HD  controller 
hardware  and  the  X.25  level  2  microcode  provides  a  medium  speed  synchro- 
nous mterlace  called  the  KMX.  The  KMSID^BD  supports  eight  lines,  onlv 

L''^tL  ""  T  V  '"'"'  ^"^  ^'■^''■'^  simultaneously.  Similarly,  the  combination  of  the 
KMSll-PX  controller  hardware  and  uhe  X.2o  level  2  microcode  provides  a 
medium  speed  synchronous  interface  called  the  KMX. 
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2.4.2    Line  Identification 

Vou  can  use  network  management  commands  to  modify  parameters  tor  an 
individual  line  or  for  all  known  lines.  I'se  the  KNOWN  LINES  keyword  to 
specify  all  lines  identified  to  the  system  during  network  generation.  To  specify 
an  individual  line,  use  a  line  ID  of  the  form 

dei--c{-u] 

where 


dci' 
c 

u 


is  a  device  name  from  Table  2-4. 

is  a  decimal  number  (0  or  a  positive  integer)  designating  the  device's 
hardware  controller. 

is  a  decimal  unit  numbe'-  (0  or  a  positive  integer)  included  if  the  device 
is  a  multiple  line  controller. 


You  can  use  a  wildcard  character  (*)  in  place  of  the  controller  or  unit  number 
to  specify  all  lines  in  that  category.  You  cannot  specify  a  particular  unit  if  you 
specify  a  wildcard  controller. 

Tributaries  for  a  multipoint  line  device  are  defined  at  the  circuit  level  (see 
Section  2.5.6.1). 

NOTE 

To  create  a  new  line  ID  in  the  configuration  file,  you  must 
perform  another  network  generation. 

2.4.3    Line  Parameters 

The  permanent  data  base  should  contain  line  parameters  for  all  physical  lines 
connected  to  the  local  node  or  DTE.  These  parameters  supply  information 
used  to  control  various  aspects  of  a  line's  operation.  You  can  modify  and 
display  line  parameters  by  using  the  following  commands  (which  are  de- 
scribed with  their  parameters  in  Chapter  6): 


CFE  Commands 

DEFINE  LINE 
PlRCiE  LINE 
LIST  LINE 


NCPA^NP  Commands 

SET  LINE 
CLEAR  LINE 
SHOW  LINE 


NCPA'NP  line  parameters  fall  into  two  categories:  loaded  options  and  loading 
options.  Loaded  options  are  valid  only  for  lines  that  have  already  been  loaded 
into  the  volatile  data  base.  Loading  options  apply  to  lines  that  are  currently 
being  loaded. 

Table  2-5  categorizes  all  line  parameters  according  to  line  type  and  parameter 
function.  Additional  notes  on  some  parameters  are  inc'uded  in  the  following 
sections,  but  you  should  see  Chapter  6  for  complete  details. 


c 
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Table  2-5:    Line  Types  and  Parameter  Functions 


Line  Types  and  Parameter  Functions 
All  lines 

Speiities  device  hardware  characteristiis 


Sets  line's  operational  state  i valid  lor  all 
lines  on  CKK  fonimands.  tor  PS!  onlv  on 
NTP  VM') 

Sets  hardware  transmission  mode 

P^sfiblishes  line  level  loopback  control  tor 
device  (applies  to  DMC.  DMH.  DMI'. 
DMV.  r\A.  gXA  Hnesonlyi 

Specifies  where  to  load  soltvvare 

Multipoint  DOCMP  lines 

Kstablishes  I)I)("\IH  line-pollinji  protocol 
(see  parameter  descriptions  in  Section 
2.5.S) 

PSI  lines 

Sets  counter  timer  for  event  lo^gin^ 
Establishes  trame  control 


Cimtrols  retransmission  ol  frames 


Changes  line's  owner 


Parameters 


CONI'HOM.KH  (SH 

r.MTCSH 

VKCTOH 

PKlOJill'V 

SPKKI) 

SI'ATK  (CI.KAHKDOFFONi 


DIPLKX  (Kl'M.  HALF) 
C'ONTHOLLKK  (L()()F»HA('K  NORMA!. i 

LOCATION  (FIHSIFITTOPhOV  Ni 


DFAD  I'lMKH 
DFLAY  I'lMKH 
MlI/riPOINT  DKAl) 


COl\TKF<  TIMKK 

HOLDBACK  TIMKK 
MAXIM  I'M  DATA 
MAXIMCM  WINDOW 

HKTHANSMIT  TIMKH 
MAXIMCM  H F/r R A N S M ITS 

OWNER  (DLX/RLI) 


• 


2  4  3.1  Hardware  Device  Parameters  -  During  network  generation,  vou  spec- 
ified a  number  of  parameters  that  directly  affect  the  operation  of  the  hard- 
ware device  for  a  line.  You  can  modify  this  information  as  necessary  in  any  of 
the  three  data  bases  using  network  management  commands.  If  vou  change 'the 
controller  CSR  address  on  a  line,  be  sure  to  make  the  same  change  for  anv 
other  lines  sharing  that  controller. 

On  KMC-11  devices  (KDP  and  KDZ).  use  the  UNIT  CSR  parameter  to 
modify  the  address  of  the  first  CSR.  You  must  also  specifv  the  CSR  of  the 
secondary  device  (DUP  or  DZ)  that  the  KMC  is  controlling;  In  addition,  vou 
can  use  the  L  NIT  CSR  parameter  to  modify  the  CSR  for  the  KMX  modem 
controller. 

Use  the  VECTOR  parameter  to  modify  the  address  of  the  vector  that  contains 
the  address  of  the  interrupt  service  routines  of  a  line. 
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2.4.3.2  Line  States  and  Loading  —  DECnet  users  indirectly  set  line  states  by 
setting  the  states  of  DECnet  circuits  (see  the  DEFINE/SET  commands  in 
Chapter  6).  PSI  lines  can  be  set  to  the  same  states  permitted  for  DECnet 
circuits,  except  that  P?I  line  states  are  specified  in  line  commands  (see  SET 
LINE  in  Chapter  6). 

You  can  use  the  SHOW  LINE  command  (see  Chapters  3  and  6)  to  display  the 
state  of  any  or  all  lines.  In  some  cases,  a  substate  is  also  displayed.  Cir- 
cuit/line states  and  substates  are  described  in  Section  2.5.7.1  and  are  summa- 
rized in  Table  2-7. 

Line  loading  is  directly  related  to  the  line  states  specified  either  in  the  perma- 
nent data  base  or  during  network  generation.  Lines  with  a  CLEARED  state 
are  not  loaded  when  you  load  the  DECnet-RSX  system.  Lines  with  an  OFF 
state  are  loaded,  but  must  be  turned  on  in  the  volatile  data  base  (PSI  lines  are 
turned  on  at  the  line  level,  and  non-PSI  lines  are  turned  on  at  the  circuit  level 
—  see  Section  2.5.7.1). 

2.4.3.3  PSI  Parameters  —  The  following  considerations  should  be  reviewed 
when  modifying  the  related  parameters. 

Frame  control.  In  the  permanent  data  base,  the  maximum  data  and  window 
size  parameters  were  set  to  defaults  for  the  PSN  to  which  the  line's  DTE  is 
connected.  Consult  the  RSX-II  PSI  Network-specific  Information  manual  for 
details  of  these  values  before  you  modify  them. 

Frame  retransmission.  When  you  specify  a  value  for  the  retransmit  timer, 
be  sure  to  account  for  the  speed  of  the  line  and  the  block  size. 

2.4.4    Line  Counters 

DECnet  software  automatically  maintains  statistics,  called  counters,,  for  most 
lines  in  the  network.  Line  counters  for  DDCMP  lines  include  the  number  of 
bytes  and  data  blocks  sent  and  received,  local  and  remote  process  errors,  and 
the  amount  of  time  since  the  counters  were  last  zeroed.  DECnet-RSX  main- 
tains these  counters  for  all  DDCMP  lines  except  DMC/DMR  and  DMP/DMV 
point-to-point  lines. 

Line  counters  for  Ethernet  lines  include  the  number  of  bytes,  multicast  bytes, 
data  blocks,  and  multicast  blocks  sent  and  received;  the  number  of  blocks 
deferred  or  sent  after  collision;  and  the  number  of  send  failures  and  discarded 
frames. 

NOTE 

The  UNA  returns  line  counter  information  only  if  a  circuit  is 
active  on  the  line. 

RSX-11  PSI  line  counters  include  such  information  as  bytes  and  data  blocks 
sent  and  received,  inbound  and  outbound  data  errors,  and  local  and  remote 
reply  timeouts,  buffer  errors,  and  process  errors.  These  counters,  together  with 
component  characteristics,  are  useful  in  monitoring  the  activity  of  PSI  lines. 

For  more  information  on  using  counters,  see  Section  2.7.  For  a  complete 
listing  of  line  counters,  see  Appendix  E. 
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2.5    Circuits 


Circuits  are  high  level  communications  paths  between  nodes  or  DTEs  (data 
terminal  equipment  supported  by  PSI).  Circuits  are  the  logical  connections 
between  two  nodes  (or  all  nodes  -  on  an  Ethernet  cable)  that  operate  over  the 
physical  medium  of  lines, 

DECnet-RSX  supports  five  types  of  circuits:  DDCMP,  PCL  Ethernet  DLM 
and  PSI.  Each  is  briefly  described  below.  Circuit  ID  formats  are  outlined  later 
in  this  chapter.  For  more  information  on  circuits,  refer  to  the  Introduction  to 
UtCnet. 

2.5.1    DDCMP  Circuits 

DDCMP  circuits  provide  the  logical  connection  between  two  adjacent  nodes 
I  hey  are  classified  according  to  the  type  of  line  over  which  they  operate: 

•  A  point-to-point  circuit  connects  two  nodes  over  a  corresponding  point-to- 
point  line. 

•  A  multipoint  circuit  operates  over  a  multipoint  line,  which  serves  more  than 
two  nodes.  On  a  multipoint  line,  the  multipoint  control  circuit  is  affiliated 
with  the  line  s  control  station.  In  addition,  there  is  one  multipoint  tributary 
circuit  for  every  tributary  on  the  line. 

You  can  specify  multiple  circuits  from  the  control  (master)  end  of  a  control 
line,  with  each  circuit  having  a  unique  physical  tributarv  addre.ss.  From  the 
tributary  (slave)  end,  you  have  only  one  multipoint  tributary  circuit  per  line. 

2.5.2  PCL  Circuits 

PCL  circuits  provide  point-to-point  connections  between  up  to  16  nodes  on  a 
hne  by  means  of  a  parallel  time  division  multiplexed  (TDM)  bus  The 
PCL-llB  hardware  allocates  a  fraction  of  available  bus  bandwidth  to  each 
station. 

Each  PCL-llB  node  is  configured  as  a  control  station.  From  the  perspective 
of  an>-  PCL- 1  IB  node  on  the  bus,  other  PCL-1  IB  nodes  appear  to  be  tributar- 
ies. However,  the  concepts  of  active,  dying,  and  dead  tributaries  do  not  applv 
bach  station  is  assigned  a  unique  tributary  address,  which  is  established  when 
the  hardware  is  installed. 

2.5.3  Ethernet  Circuits 

Ethernet  circuits  provide  for  multiaccess  connection  among  all  of  the  nodes  on 
the  same  Ethernet  cable.  An  Ethernet  circuit  differs  from  other  DECnet  cir- 
cuits in  that  you  connect  not  to  a  single  node,  but  to  manv.  Each  node  on  a 
single  Ethernet  circuit  is  considered  to  be  adjacent  to  everv  other  node  on  the 
circuit  and  equally  accessible.  For  detailed  information  on  Ethernet  refer  to 
the  .\etuorks:  Ethernet  f^roducts  and  Services  Catalog 
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2.5.4    DLM  Circuits 

A  data-link-mapping  (DLM)  circuit  is  a  DECnet  circuit  that  uses  PSI  facili- 
ties to  connect  DECnet  nodes.  DLM  supports  two  types  of  PSI  circuit: 

•  Permanent  virtual  circuit  (PVC).  Provides  a  permanent  path  between  the 
local  DTE  and  the  remote  DTE  (analogous  to  a  leased  line). 

•  Switched  virtual  circuit  (SVC).  Provides  a  temporary  path  between  the 
local  DTE  and  the  remote  DTE  (analogous  to  a  dial-up  line).  An  SVC  is  set 
up  using  network  management  commands  only  when  there  is  data  to 
transmit  and  is  cleared  when  the  transfer  is  complete.  The  SVC  can  be 
designated  exclusively  for  incoming  or  outgoing  calls  (see  DEFINE  CIR- 
CUIT USAGE). 


2.5.5    PSI  Circuits 

A  PSI  circuit  is  a  virtual  circuit  connecting  local  data  terminal  equipment 
(DTE)  with  a  remote  DTE.  PSI  circuits  operate  differently  from  DECnet 
circuits.  All  PSI  circuits  pass  through  the  X.25  protocol  module  (see  Section 
2.9.1),  which  multiplexes  circuits  to  lines  that  it  owns.  As  such,  there  is  no 
direct  relationship  between  the  name  of  a  PSI  circuit  and  a  PSI  line,  other 
than  the  arbitrary  one  that  designates  whether  the  circuit  is  used  for  DECnet 
or  for  PSI  network  operations. 

PSI  supports  the  use  of  both  PVCs  and  SVCs  (see  definitions  in  Section  2.5.4). 
Native  PSI  SVCs  are  set  up  with  parameters  taken  from  the  X.25  protocol 
module  component  when  calls  are  requested  on  these  circuits.  Refer  to  Chap- 
ter 6  for  details  on  specifying  parameters  for  PVCs  in  CFE,  NCP,  and  VNP 
commands. 

PSI  circuits  are  used  in  two  ways: 

•  For  user  application  programs  (PSI  native  circuits). 

•  For  the  mapping  of  data  link  information  from  the  DECnet  Transport  layer 
via  the  X.25  protocol  module  of  the  local  DECnet/PSI  node  to  the  X.25 
protocol  module  of  a  remote  DECnet/PSI  node.  DLM  (see  Section  2.5.4) 
enables  the  use  of  the  X.25  protocol  for  DECnet  node-to-node  communica- 
tion. 
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2.5.6    Circuit  Identification 

You  can  use  network  management  commands  to  modify  parameters  for  an 
individual  circuit  or  tor  all  known  circuits.  I'se  the  KNOWN  riHd'ITS 
keyword  to  specify  all  circuits  identified  to  the  system  during;  network  genera- 
tion (including  circuits  that  are  active  and  circuits  whose  state  is  OFF).  To 
specify  an  individual  circuit,  use  the  (IRd'IT  keyword  and  a  circuit  II). 
DFC'net  and  PSI  circuits  have  different  formats,  as  described  in  the  following 
sections. 


NOTE 

You  can  modify  circuii  parameters  only  for  DKCnet  circuits 
defined  in  the  permanent  data  ba.se  during  network  generation. 
If  you  want  to  create  another  circuit  ID  in  the  i)ermanent  data 
base,  you  have  to  do  another  network  generation. 

2.5.6.1     DECnet  Circuit  Identification  (DDCMP,  PCL,  Ethernet  circuits)  — 

specify  an  individual  DECnet  circuit,  use  a  circuit  ID  of  the  form 

d(T-c{-u][.t] 
where 


I 


o 


del       is  a  device  name  from  Table  2-4  (for  exami)le,  DMC,  PCL.  CNA). 

c  is  a  decimal  number  (0  or  a  positive  integer)  designating  the  device's 

hardware  controller. 

u  is  a  decimal  unit/circuit  number  (0  or  a  positive  integer)  included  if  the 

device  is  a  multiple  line  controller. 

t  is  a  decimal  number  identifying  a  tributary  circuit  on  a  multipoint  line. 

You  can  use  a  wildcard  character  (*)  in  place  of  the  controller,  unit,  or  tribu- 
te -y  number  to  specify  all  known  circuits  in  that  categ(^ry.  You  can  use  multi- 
ple wildcards  in  a  circuit  ID,  as  long  as  no  numbers  follow  them.  Some  exam- 
ples of  DKCnet  circuit  IDs  follow: 

Circuit  ID  Meaning 

IN.Al  I'N.A.  nmtn.ller  1 

DZ-()-4.2  nZ.  lontroller  0.  unit  4.  tri))utarv  2 

DZ-()-4.*  DZ.  all  known  tributane.-  on  unit  4  ol  ((tntniller  0 

t)l--l-'?  I)L.  controller  I.  tributary  :\ 

PCL-O"  f'( "I.,  all  known  tributane>  on  controller  0 
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Table  2-6:    Circuit  Types  and  Parameter  Functions 


Circuit  Types  and  Parameter  Functions 

All  circuits  (except  PSI) 

Sets  iirruit'>  upprational  state 

Spei  ifies  rirc  lut  owner 

Spei'ities  circuit  cnst  tor  routing 

Sets  frequency  ot  routing  on  i  ircuit 

Sperities   whether  downline   l(»ading  and 
l(»<>phaik  testing  are  enabled 

Multipoint  ODCMP  circuits 

Sets  tributary  address  tor  iircuit 

Specilies  tributary  [)(>lling  rate 

PCL  circuits 

Sets  tributar\  ad(ires>«  for  t  ircuit 

Ethernet  circuits 

Speeities  router  parameters  tor  unuit 

DLM  circuits  (PVCs  or  SVCs) 

Controls  data  pai  ket>  tor  l'\('s  and  S\("s 

Specifies  channel  an(i  DTK  tor  a  l'\(" 


("ontroU  retransmission  when  establishing 
an  S\(' 

Specifies  asailability  of  an  S\'('  tor  incoin 
inii  or  outgoing  calls 

PSI  native  PVCs 

Specifies  channel  and  DTK  tor  a  V\'C 

Sets  counter  timer  for  event  logging 
Contntls  data  packets  tor  P\('^ 


Parameters 

STATK  (CLKAHKI)  OVV  ON  SKKVKKi 

OWNKH  iDIA  XPli 

COS  r  • 

HF.LLO  IIMKH  * 

SKHVICK  (I)ISAHLKI)1:NAHI,KI)i 


rHlHirAHY 
Mll/rH'OlNT  ACTIVK 

rHlHCrAHV 


MAXIMIM  HHOADCAST  HOIIKHS 
HOITKH  l'KI')HrrY 


MAXIMIM  DAI  A 
MAXIMIM  WINDOW 

CHANNKI. 
DTK 


Assigns  remote  DTK  address  for  an  SVC  NIMBKR 


MAXIMIM  HKCALLS 
HKCAM,  I'lMKK 

rSA(;K  (INCOMINO  onXiOlNC) 


CHANNKL 
DTK 

COrNTKH  TIMKH 

MAXIMIM  DATA 
MAXIMIM  WINDOW 


*     See  parameter  descriptions  in  Section  '2:2.2. 
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—    Circuit  IDs  for  DLM  PVCs  and  SVCj 


2.5.6.2    DLM  Circuit  Identification 

have  the  form 

DLM-x.>' 
where 


identifies  a  group  code  analogous  to  the  controller  number  on  a  device. 
You  can  use  this  to  group  .jLM  circuits  according  to  type  (for  example, 
all  PVCs  could  have  the  same  group  code). 

identifies  the  circuit  number  analogous  to  the  logical  number  associated 
with  tributaries  for  a  device. 


2.5.6.3  PSI  Circuit  Identification  -  Circuit  IDs  for  PSI  PVCs  consist  of  a 
strmg  of  1  to  6  alphanumeric  characters.  You  cannot  identifv  SVCs  for  PSI 
circuits. 

2.5.7    Circuit  Parameters 

The  permanent  data  base  contains  circuit  parameters  for  all  circuits  con- 
nected to  the  local  node  or  DTE.  You  can  modifv  and  displav  circuit  parame- 
ters by  using  the  following  commands  (which  are  described  with  their  parame- 
ters in  Chapter  6): 


CFE  Commands 

DEFI.NE  riRClIT 
PIRGE  CIRCIIT 
LIST  CIRCriT 


NCPA^NP  Commands 

SET  riRcriT 

CLEAR  CIRCriT 
SHOW  CTRCIIT 


Table  2-6  categorizes  all  circuit  parameters  according  to  circuit  tvpe  and 
parameter  function.  Additional  notes  on  some  parameters  are  included  in  the 
following  sections,  but  you  should  see  Chapter  6  for  complete  details. 

2.5.7.1  Circuit  States  and  Loading  —  You  control  the  operational  state  of  all 
circuits  at  the  local  node.  This  allows  you  to  control  circuit  traffic  and  to 
perform  service  functions  on  DDCMP  circuits.  The  state  of  a  circuit  can  affect 
the  reachability  of  an  adjacent  node.  Use  the  STATE  parameter  to  set  one  or 
all  known  circuits  to  one  of  the  following  states: 


CLEARED 


OFF 


In  the  permanent  data  base,  this  state  means  that  the  circuit  is 
not  loaded  when  the  network  is  loaded  and  is  unavailable  for 
use.  even  though  it  is  defined  in  the  permanent  data  base. 

In  the  volatile  data  ba.se  or  the  system  image  fue,  this  state 
means  that  the  associated  line  has  not  been  loaded  and  is  una- 
vailable for  use. 

In  the  permanent  data  base,  this  state  means  that  the  circuit  is 
lc.:<ded  when  the  network  is  loaded,  but  is  not  being  used. 

In  the  volatile  data  ise  or  the  system  image  file,  this  state 
means  that  the  circuit  is  turned  off 
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0\ 


servicp: 


In  the  permanent  data  base,  this  state  means  that  the  circuit  is 
loaded  and  available  for  use  when  the  network  is  loaded. 

In  the  volatile  data  base  or  the  system  ima^e  file,  this  state 
means  that  the  circuit  is  available  for  use. 

This  state  exists  only  in  the  volatile  data  base  and  the  system 
image  file  and  is  valid  for  DPXnet  nodes  only.  It  means  that  the 
circuit  is  reserved  for  service  functions  such  as  up-line  dump- 
ing, down-line  system  loading,  or  circuit  level  loopback  testing. 


Table  2-7:    Circuit/Line  States  and  Substates 


state 

Substate 

CLEARED 

none 

OFF 

none 

ON 

-RINM.NG 

(not  displayed) 

-STARTING 

-AITO.SERVICE 

-lOADING 

-AITOLOADING 

-Dl'MPING 

-AITODIMPING 

-TRIGGERINC; 

-AITOTRIGGERING 

-LOOPING 

-REFLECTING 

SERVICE 


-FAILED 

-IDLE 

(not  di-splayed) 

-LOADLNG 
-DUMPING 
TRIGGERING 
-LOOPING 

-REFLECTING 


Meaning 

The  line  has  not  been  loaded. 
The  circuit/line  is  not  being  used. 
The  circuit/line  is  in  normal  use. 

The  circuit  is  in  the  (Transport)  initialization 
cycle. 

The  circuit  is  reserved  for  autotnhtic  ser\ice 
use. 

The  circuit  is  in  use  for  loading. 

The  circuit  is  in  use  for  automatic  loading. 

The  circuit  is  in  use  for  dumping. 

The  circuit  is  in  u.se  for  automatic  dumping. 

The  circuit  is  in  u.se  for  triggering. 

The  circuit  is  in  use  for  automatic  triggering. 

The  circuit/line  is  in  u.se  for  active  l(K)pback 
testing. 

The  circuit/line  is  in  use  for  passive  loopback 
testing. 

The  DLM  circuit  has  unsuccessfully  recalled  an 
S\'C  the  specified  maximum  number  of  times. 

The  circuit   is  reserved   for  an  active  service 
function. 

The  circuit  is  in  use  for  loading. 

The  circuit  is  in  u.se  for  dumping. 

The  circuit  is  in  use  for  triggering. 

The  circuit/line  is  in  u.se  for  active  Iwpback 
testing. 

The  circuit/line  is  in  use  for  pa.ssive  loopback 
testing. 
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circuit  substates.  When  you  use  the  \CP  SHOW  CIRmT  or  SHOW  LINK 
commands  (see  Chapter  3).  the  system  displays  the  state  to  which  you  have 
most  recently  set  the  circuit(s).  In  some  cases,  it  also  displays  one  of  the 
suhstates  listed  in  Table  2-7. 

DECnet  software  can  automatically  change  the  state  of  a  circuit  for  certain 
functions.  For  example,  if  you  or  a  remote  user  initiate  a  loopback  test  over  a 
circuit,  DECnet  network  management  software  automatically  changes  the 
state  of  that  circuit  to  the  appropriate  internal  state  (or  substate). 

Several  circuit  substate>  have  an  AITO-  prefix.  These  substates  can  occur 
when  you  have  an  adjacent  node  that  is  about  to  be  or  is  in  the  process  of 
being  automatically  down-line  loaded  or  triggered.  For  example,  if  a  circuit  is 
on  and  the  local  node  senses  a  request  for  a  down-line  load  on  that  circuit,  the 
networii  management  software  on  the  local  node  automatically  sets  the  circuit 
to  the  ON-AITOSERVICE  state. 

Table  2-7  lists  all  circuit  states  and  substates  and  their  meanings.  These 
states  and  substates  also  apply  to  PSI  lines.  Refer  to  the  D^A  Network 
Management  Functional  Specification  for  further  information  about  line 
states,  substates,  and  their  transitions. 

2.5.7.2  Circuit  Ownership—  On  each  network  node,  there  are  processes  that 
can  own  the  different  circuits  and  control  traffic  over  them.  LVe  the  OWNER 
parameter  in  the  SET  CIRCUIT  command  to  set  the  circuit  owner  to  match 
the  owner  for  the  a.ssociated  DECnet  line.  There  are  two  po.ssible  owners  for 
DDCMP  circuits: 


DLX 


XPT 


The  Direct  Line  Access  Controller.  When  DLX  owns  a  circuit,  you  can 
use  the  circuit  as  an  I/O  device  (that  is,  you  can  direct  circuit  traffic 
at  the  Data  Link  level).  The  DECnet-RSX  Programmer's  Reference 
Manual  describes  the  DLX  user  interface:  the  Data  Link  layer  of  the 
Digital  Network  Architecture  is  de.scribed  in  the  Introduction  to 
DECnet. 

The  Transport  layer.  When  XPT  owns  a  circuit,  a  network  user  can 
perform  normal  logical  link  operations  over  it.  The  Introduction  to 
DECnet  describes  the  Transport  layer  of  the  Digital  Network  Archi- 
tecture. 


DECnet  software  can  temporarily  override  XPT  as  the  owner  of  a  DDCMP 
circuit  and  reserve  the  circuit  for  the  following  service  functions: 

•  Down-line  system  loading  to  a  remote  node 

•  Up-line  dumping  from  a  remote  node 

•  Triggering  a  remote  node 

•  Loopback  testing  for  a  circuit  at  the  physical  link  level 
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In  these  situations,  the  circuit  owner  remains  XPT,  but  XPT  cannot  use  the 
circuit  until  the  service  function  has  finished  using  the  circuit.  DDCMP  cir- 
cuits can  be  reserved  for  the  service  functions  Hsted  above  by  setting  the 
circuit  to  the  SERVICE  stau   in  the  volatile  data  base  (see  Section  2.5.7.1). 

By  default,  the  owner  of  DLM  circuits  is  XPT,  and  the  owner  of  PSI  circuits  is 
the  NW  process.  Since  Ethernet  circuits  allow  access  by  multiple  users,  they 
do  not  have  exclusive  owners. 


2.5.8    DDCMP  Multipoint  Circuit  Parameters 

DECnet-RSX  supports  DDCMP  multipoint  circuits  for  the  following  devices- 
DL-11.  DLV-11,  DMP-11,  DMV-11,  DU-11,  DUP-11,  DPV-11,  DUV-11 
DV-11.  DZ-11,  KDP-11.  and  KDZ-11.  The  following  sections  describe  multi- 
pomt  operation,  including  the  parameters  you  can  modifv  to  control  device 
operation.  Multipoint  characteristics  are  defined  at  both  the  line  and  the 
circuit  level.  Applicable  parameters  are: 


For  lines: 


For  circuits: 


DEAD  TIMER  (for  DMP  and  DMV  devices  only) 
DELAY  TIMER  (for  DMP  and  DMV  devices  onlv) 
MULTIPOINT  DEAD 

MULTIPOINT  ACTIVE 
TRIBUTARY 


Circuit  parameters  apply  to  a  specific  tributary.  Line  parameters  applv  to  all 
tributaries  on  the  specified  line(s). 

2.5.8.1  Multipoint  Operation  —  A  multipoint  circuit  has  one  control  station 
and  multiple  tributaries.  The  control  station  continually  polls  existing  (that 
IS.  on-line)  tributaries  for  data  awaiting  transmission.  A  tributary  is  always 
given  the  opportunity  to  respond  when  it  is  polled.  If  the  tributary  is  active,'it 
either  transmits  data  or  returns  an  ACK  (positive  acknowledgement)  if  it  has 
no  data  to  transmit.  Whenever  the  control  station  has  data  for  a  tributary,  it 
transmits  the  data  immediately. 

An  active  tributary  is  one  with  the  circuit  turned  on.  If  the  control  station 
does  not  get  a  response  for  two  consecutive  polls,  it  considers  the  tributary  to 
be  dying  and  polls  less  frequently.  If  the  tributary  does  not  then  respond  to 
the  next  six  polls,  the  control  station  considers  it  to  be  dead  and  polls  it  even 
less  frequently.  If  a  dead  tributary  begins  to  respond,  it  is  reclassified  as  active 
and  is  polled  at  the  original  active  polling  rate. 

DECnet  software  uses  polling  ratios  to  control  polling  rates  for  active  and 
dead  tributaries.  The  polling  ratios  have  svstem  defaults,  but  vou  can  use  the 
commands  SET/DEFINE  CIRCUIT  MULTIPOINT  ACTIVE  and  SET/DE- 
FINE LINE  MULTIPOINT  DEAD  (except  for  DMPs  and  DMVs)  to  modifv 
them  (see  Chapter  6  for  details).  For  DMPs  and  DMVs,  vou  must  use  the 
DEAD  TIMER  and  DELAY  TIMER  parameters  described  later  in  this  sec- 
tion. 
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The  control  station  polls  each  active  tributary  every  nth  time  it  goes  through 
the  polling  list  (n  is  the  active  polling  ratio  set  for  that  tributary).  The  default 
ratio  is  1,  meaning  thai  unspecified  active  tributaries  are  polled  each  time  the 
control  station  goes  through  the  polling  list.  There  is  one  dead  ratio  (default  - 
8)  for  all  tributaries  on  a  line.  The  control  station  polls  one  dead  tributarv- 
each  .V  times  through  the  polling  list  (in  round  robin  fashion).  The  contnil 
station  polls  a  dying  tributary  four  times  as  often  as  a  dead  one  (or  one-fourth 
the  dead  polling  ratio). 

For  example,  using  the  defaults,  an  active  tributar>-  is  polled  once  a  second,  a 
dying  tributary  once  every  two  seconds,  and  one  of  the  dead  tributaries  every 
eight  seconds.  The  exact  frequency  at  which  a  particular  tributary  is  polled 
depends  not  only  on  its  active  ratio,  but  also  on  the  states  and  active  ratios  of 
other  tributaries  on  the  circuit  and  the  amount  of  traffic. 

To  control  which  tributaries  are  active,  set  the  related  circuit  state  to  ON  or 
OFF.  Note  that  dead  tributaries  are  always  polled  if  they  are  on.  To  improve 
performance  for  active  tributaries,  it  is  best  to  turn  dead  tributaries  off  if  they 
will  be  dead  for  a  significant  period  of  time.  You  must  also  u.se  the  TRIBl'- 
TARY  parameter  to  specify  an  address  to  be  used  by  the  polling  mechanism. 
Correspondingly,  you  must  set  the  same  tributary  address  tor  that  circuit  on 
the  remote  node. 


• 


2.5.8.2  DMP  and  DMV  Multipoint  Controliers  —  For  DMP  and  DMV  control- 
lers, you  set  the  polling  rates  by  using  the  DEAD  TIMER  and  DELAY 
TIMER  parameters  in  the  SET  LINE  command  (see  Chapter  6). 

The  DEAD  TIMER  parameter  specifies  the  polling  rate  for  a  dead  tributary. 
Start  by  setting  the  DEAD  TIMER  parameter  to  a  value  midway  between 
5000  and  30,000;  then  adjust  the  rate  to  sjit  your  network.  If  there  are  no 
problems  with  the  rate  you  have  set,  you  may  wish  to  set  a  higher  rate  to 
maximize  performance. 

The  DELAY  TIMER,  which  specifies  the  maximum  time  to  wait  between 
polls  in  order  to  limit  the  effect  of  a  fast  control  station  on  a  slow  tributary, 
can  have  any  of  the  following  values: 


0 

50 
200 


for  lines  with  speeds  equal  to  or  greater  than  56Kb 

for  multipoint  EIA  lines  with  speeds  up  to  19.2Kb 

if  any  DDCMP  software  implementations  are  on  the  line 


Alvv ays  choose  the  larger  value  if  more  than  one  could  apply. 
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2.5.9    Ethernet  Circuit  Parameters 

There  are  two  routing  parameters  that  can  he  specified  for  Kthernet  circuits  in 
the  DEFINK  riR(H'IT  command. 

ROl  TKFi  PRIORITY  —  When  two  or  more  routing  nodes  are  connected  to  an 
Kthernet  cahle.  the  routing  node  with  the  highest  priority  (a  vahie  in  the 
range  of  0  to  127)  hecomes  the  router  designated  to  provide  routing  services  for 
the  end  nodes  on  the  Kthernet.  (Knd  nodes  on  the  same  Kthernet  cahle  can 
communicate  directly  with  one  another;  routers  are  required  to  send  messages 
to  nodes  that  are  not  ccmnected  to  the  Kthernet.)  If  two  nodes  share  the 
highest  pri»)rity.  the  node  with  the  highest  node  address  is  selected.  To  learn 
which  router  is  the  designated  router,  issue  a  SHOW  (TR(T'IT  command. 

Example: 

NCP  SHOW  CiryCUIT  UNA-0  CHARAC  TER  I  ST  I  CS 

CircMit  characieristics  as  of  3-0CT-83  I5:t;i3:27 

C  1  r  c  M  1  t     =    UNA-0 

Co  5 1     -     1  .     ouir,  e  r     =  ;;PT 

T  V  p  e    --    E  I  h  e  r  ri  e  t 

Design  ate  dro'.iter  =    2:^(rY06IN) 

R  0  M  t  e  r    p  r  1  0  r  1 1  V    =  7 1  j 


MAXIMIM  BROADCAST  ROITKRS  -  This  parameter  specitles  the  maxi- 
mum number  of  routers  (other  than  the  executor  node)  to  he  allowed  on  the 
identified  Kthernet  circuit.  The  practical  maximum  number  of  routers  is 
about  10  because  of  the  control  traffic  overhead  (composed  of  routing  mes- 
sages and  hello  messages).  The  absolute  maximum  number  of  routers  is  :V2. 

2.5.10    DLM  Circuit  Parameters 

Several  circuit  parameters  that  are  specific  to  the  operation  of  DLM  circuits 
are  described  in  the  following  sections. 

2.5.10.1  Remote  DTE  Addresses  —  To  establish  an  SVC  with  a  remote  DTK. 
the  routing  layer  of  DKCnet  software  requires  the  address  of  the  remote  DTK. 
I'se  the  NT'MBKF  parameter  in  the  DKFINK  CIRCriT  command  to  specify 
the  remote  DTK  address  for  an  outgoing  DLM  SV(\  The  suhaddress  that  you 
specify  as  the  last  number(s)  of  the  DTK  address  must  fall  into  the  subad- 
dresses  range  that  is  specified  for  the  target  node  (see  Section  2.\:\.2), 

2.5.10.2  Re-catts  for  DLM  Circuits  —  If  an  attempt  to  establisn  a  DLM  SVC 
has  been  unsuccessful.  DKCnet-RSX  attempts  to  re-call  the  number.  The 
RKCALL  TIMKR  parameter  sets  the  interval  that  DKCnet  should  wait  before 
attempting  a  re-call  (default:  'M)  seconds)  and  the  MAXIMCM  RKCALLS 
parameter  specifies  the  maximum  number  of  times  that  DKCnet  should  at- 
tempt a  re-call  (default:  o).  V(,u  can  modify  either  of  these  valuer  in  a  DK- 
FINK. CIRCriT  command  (see  Chapter  6), 
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II'  the  defined  maximum  re-call  number  is  exceeded,  the  circuit  is  placed  in 
the  OX-FAILKD  state,  and  you  must  execute  a  SKT  CIHCl  IT  S  TA  TK  ON 
command  before  another  outgoing  call  can  be  attempted. 

2.5.11    PSI  Circuit  Parameters 

If  you  configured  a  PSI  capability  into  your  system,  you  can  modify  certain 
information  that  you  specified  during  network  generation  by  using  the  I)K- 
FIXK  riRdTl'  command  with  the  parameters  listed  for  PSIcircuits  in  Table 
2-B.  If  you  use  this  command  to  n.odify  the  as.sociation  of  a  PV('  with  a  local 
dtp:,  the  same  DTK  address  must  be  specified  in  the  protocol  module  (see 
DEFINE  MODULE  X2rvPR0T0(X)L  in  Chapter  (]).  Note  that  beth  the 
packet  and  window  size  parameters  were  set  to  defaults  for  the  PSN  to  which 
the  circuit's  DTE  is  connected.  Consult  the  HSX  J I  PSI  Xrtirorh-sprcific 
Infnrnwtiim  manual  for  details  of  these  values  before  you  modify  them. 

PSI  channels.  All  virtual  circuits  for  a  DTE  are  multiplexed  over  the  physi- 
cal link  between  the  DTE  and  the  network  interface  (I)CE).  Each  virtual 
circuit  has  a  logical  channel  over  which  data  is  transmitted  at  both  tht  DTE 
and  D(^E  interfaces.  Each  channel  is  identified  bv  a  unique  reference  number 
called  a  logical  channel  number  (LCN).  Each  DTE  assigns  a  channel  to  the 
virtual  circuit  and  recognizes  the  virtual  circuit  onlv  bv  the  LCN  that  identi- 
fies that  channel.  You  use  the  CHANNELS  parameter  of  the  DEFINE  MOD- 
l  LE  X25-PH0T0C0L  command  to  associate  the  LCN  with  the  DTE  (see 
Chapter  6). 

Drring  network  generation,  you  assigned  a  channel  to  each  PVC.  To  modify 
the  logical  channel  number  associated  with  a  circuit  in  the  permanent  data 
ba.se.  use  the  CHANNEL  parameter  in  the  DEFINE  CIRCCIT  command. 
You  should  not  specify  an  LCN  that  has  already  been  assigned  to  an  outgoing 
call  in  the  protocol  module.  PVC  LCNs  are  assigned  by  the  network  vendor 
when  the  PVC  is  set  up 


2.5.12    Circuit  Counters 

DECnet-RSX  automatically  maintain-  certain  statistics,  called  counters,  for 
circuits  in  the  network.  For  all  circuits,  counter  information  can  include  the 
number  of  me.ssages  sent  and  received  over  the  circuit,  timeouts,  and  the 
amount  of  time  since  the  counters  were  last  zeroed.  For  DDCMP  circuits 
counters  ar-  maintained  for  timeouts  and  for  data  and  buffer  errors.  For  both 
Ethernet  and  DDCMP  circuits,  the  number  of  bvtes  and  data  blocks  sent  and 
received  are  recorded.  For  PSI  circuits,  the  following  statistics  are  indicated  in 
counters:  the  time  since  the  counters  were  zeroed:  the  number  of  bytes,  data 
blocks,  and  resets  sent  and  received:  the  number  of  resets  initiated  bv  the 
network. 


For  more  information  on  using  counters,  see  Section  2.7 
listing  of  circuit  counters,  see  Appendix  E. 


For  a  complete 
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2.6    Logging 


DECnet-RSX  software  logs  certain  network-rp'ated  events  that  occur  during 
network  operation.  An  event  is  defined  as  a  network  or  system-specific  occur- 
rence for  which  the  event  logger  maintains  a  record.  Some  events  that  can  be 
recorded  are  Hsted  below.  A  complete  list  is  provided  in  Appendix  D. 

•  Changes  in  line,  circuit,  node,  and  module  states 

•  Lost  events  (events  that  were  not  logged) 

•  Service  requests  (when  a  line  is  put  in  an  automatic  service  state) 

•  Passive  loopback  (when  the  executor  is  looping  back  circuit  or  line  level  test 
messages) 

•  Line,  circuit,  node,  and  module  counter  activity 

This  information  can  be  useful  in  maintaining  and  tuning  the  network  be- 
cause it  can  be  recorded  continuously  by  the  event  logger.  Section  3.3.2  pro- 
vides an  example  of  a  typical  event-logging  situation  with  multiple  nodes. 

As  system  manager,  you  are  responsible  for  controlling  various  aspects  of 
event  logging.  For  details  on  CFE.  XCP,  and  VNP  logging  commands,  see  the 
following  command  descriptions  in  Chapter  6. 


CFE  Commands 

DEFINE  LOr.r.ING 
PURGE  LOGGING 
LIST  LOGGING 


NCP/VNP  Commands 

SET  LOGGING 
CLEAR  LOGGING 
SHOW  LOGGING 


Table  2-8  lists  all  logging  parameters  by  function  and  groups  them  according 
to  operational  categories. 

Table  2-8:    Logging  Parameters  and  Their  Functions 


Parameter  Function 

Event  specification 

Source  of  events 


Location  to  log  events 


Logging      component 
name 

State  of  logging  compo- 
nent on  executor  node 


Event  Source 
Parameters 

EVENTS  eient-list 
KNOWN  EVENTS 

riRCLIT 

LINE 

MODULE 


NODE 


X2.VPR0T0C0L 

X25-SERVER 

X29-SERVER 


Logging  Component 
Parameters 


SINK      EXEdTOR 
NODE  node-id 
NODE  SHOST 

NAME 


STATE      OFF 
ON 
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Following  network  generation,  all  events  generated  by  any  component  known 
to  the  local  node  are  automatically  logged  at  the  executor  console.  You  can 
use  the  SET  LOGGING  command  to  specify  that  only  certain  events  be 
logged  for  certain  components:  a  specified  node.  line,  circuit,  or  module  (X'^'v 
PROTOCOL.  X25-SERVER,  or  X29-SERVER). 

To  remove  any  or  all  parameters  from  the  volatile  data  base,  use  the  CLEAR 
LOGGL\G  command. 


2.6.1    Event  Specification 

Events  are  defined  by  class  and  type.  For  the  most  part,  events  are  logged  for 
the  various  DXA  layers  and  for  system-specific  resources.  You  can  specify  the 
kinds  of  events  to  be  logged  by  using  the  following  event  list  format  with  the 
EVEXl'S  parameter: 

class,  type 

whero 

class      identifies  the  DXA  layer  or  system-specific  resource  to  which  the 
event  pertains. 

type      identifies  a  particular  form  of  event,  unique  within  an  event  class. 

For  example,  events  in  the  Transport  layer  are  assigned  to  class  4.  The  event 
types  for  this  class  range  from  0  through  19.  Event  wpe  0  indicates  aged 
packet  loss,  event  type  1  indicates  unreachable  node  packet  loss,  and  so  forth 
(see  Appendix  D  for  a  complete  listing  of  events  by  class  and  type).  Use  the 
EVENTS  parameter  to  specify  a  list  of  events  to  be  logged.  To  specify  logging 
of  all  DNA  event  classes  and  types  that  can  be  generated  bv  a  DECnet-RSX 
node,  use  the  KNOWN  EVENTS  parameter.  When  removing  logging  param- 
eters, use  either  of  the  above  qualifiers,  or  specify  ALL  EVENTS  when  you 
want  to  clear  not  only  all  DNA  events  but  also  all  user-defined  events. 

When  providing  an  event  list  for  the  EVENTS  parameter,  vou  can  specify 
only  one  class,  but  you  can  specify  multiple  event  types  within  a  class.  You 
can  specify  a  single  event  type,  a  range  of  types,  a  combination  of  these,  or  a 
wildcard  character  (*).  The  following  examples  illustrate  the  format  of  each. 


Event  List 
4.4 

4.5-7 
4.5.7-9.11 


Meaning 

Specifies  event  cla.ss  4.  type  4. 

Specifies  event  class  4.  types  5  through  7. 

Specifies  event  class  4.  types  5.  7  through  9.  and  11.  Note  that  types  must 
be  specified  in  ascending  order. 


2.6.2    Event  Logger  Components 

Events  can  be  logged  on  any  of  the  following  components:  a  console,  a  file, 
and/or  a  monitor  program  (as  determined  at  network  generation).  A  console  is 
any  record-oriented  device  that  receives  events  in  ASCII  format.  A  file  is  a 
user-specified  file  that  receives  events  in  a  DNA  machine-readable  binary 
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format.  A  monitor  program  is  a  system-  or  user-supplied  program  that  re- 
ceives and  processes  those  events.  Refer  to  the  /;.\V\  Nrtimrh  Mann^vmvnt 
tunctmnal  Spccifirntinn  for  a  description  of  the  standard  I)\A  event  format 
Appendix  C  describes  the  DKCnet-RSX  event-logging  interface.  This  infor- 
mation IS  useful  if  you  want  to  write  a  monitor  program  to  receive  events. 

One  or  more  of  the  components  listed  above  can  log  events  on  your  DP^C^net 
system.  Vou  can  also  have  the  event  logger  send  events  to  logging  components 
on  remote  DECnet  nodes  by  using  the  SINK  parameter  (see  SKT  LOCUJINC; 
in  Chapter  6). 

When  you  initially  specify  components  to  which  event  data  is  to  be  logged 
you  can  identify  them  by  u.sing  the  NAME  parameter  in  the  SET  LOCKUXci 
command.  Tse  the  CLEAR  LOGGING  NAME  command  to  dear  the  name  of 
the  loggmg  device.  This  causes  event  logging  to  be  sent  to  the  default  logging 
device  (defaults  are  listed  under  SET  LOG(;LN(i  in  Chapter  6). 


2.7    Counters 


DECnet  RSX   software   automatically   maintains  certain   statistics,   called 
counters,  for  the  following  network  components: 

•  Circuits 

•  Lines 

•  Modules  (X. 25  Protocol  and  X. 25  Server) 

•  Nodes  (including  the  executor) 

•  System 

Ail  counters  are  listed  with  a  brief  description  in  Appendix  E. 

Counters  are  maintained  on  the  node  presently  designated  as  the  executor  and 
can  mclude  such  information  as  the  number  of  data  packets  sent,  received  or 
lost  over  a  line;  system  buffer  allocation  failures;  Transport  packet  informa- 
tion; or  X.25  protocol  message  information.  Counter  statistics  are  u.seful  alone 
or  when  read  in  conjunction  with  logging  information  (see  Section  2.6  and 
Appendix  D)  to  measure  and  evaluate  the  performance  and  throughput  of 
your  network  configuration. 

As  system  manager,  you  can  display  counters  (see  Sectitm  2.7.1)  and  periodi- 
cally zero  them  (see  Section  2.7.2)  using  the  NCP  SHOW  and  ZERO  com- 
mands. In  addition,  for  PSI  circuits,  lines,  and  modules,  you  can  set  a  timer 
whose  expiration  causes  counters  for  a  given  component  to  be  logged  as  an 
event  (see  Section  2.7.3).  All  network  management  commands  for  manipulat- 
ing counters  are  described  in  detail  in  Chapter  6. 
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2.7.1    Displaying  Counters 

Vou  can  use  the  \CP  SHOW  command  (see  Chapter  fi)  to  disphiv  counters 
tor  any  of  the  network  components  listed  at  the  beginning  of  Section  2.7.  A 
sample  command  and  resulting  display  are  shown  below: 


NCP  SHOW  CIRCUIT  DMC-0  COUNTERS 


CircMit  coMfiters  as  of  25-0CT-B3  15:18 
C  1  r  c  LH  t  =  D  M  C  -  (J 


G553a 

1568 

1753 

iaG7G00 

15^4350 

3 

15 

0 

102  139870 
903788^:1 

1  G  0  G  G  ij  2 

2  C  Z  3  2  G  9 

n 

0 

0 
0 
0 


S  e  c  0  ri  d  s  s  i  i-i  c  e  last  r  e  r  o  e  d 

T  e  r  (II 1  n  a  t  1  n  3  p  a  c  K  e  t  s  r  e  c  e  i  "  e  d 

0  r  1  3  1  r,  a  t  1  r,  g  p  a  c  f;  e  t  5  s  e  ri  t 
Trarisit  pacKets  received 
T  r  a  ri  s  1  t  PacKets  s  e  r,  t 

T  r  a  ri  s  1  t  c  o  i-i  3  e  s  t  i  o  r,  1  ?  s  s 
C  1  r  c  I.I  1  t  d  0  u'  n 

1  ri  1  I  1  a  1  1  z  y  I  1  0  n  f  a  i  1  m  r  e 
E  V  t  e  s  r  e  c  p  1  1 '  e  .j 

B  .  t  e  5  5  e  I'l  I 

Data  t'lo'-t;5  received 
Data  b  1  u  c  r>  5  s  e  1"!  t 
Data  errors  i  ri  b  o  li  r.  d 
Data  errors  o  m  t  b  o  m  ri  d 
R  e  (ti  0  t  e  r  e  p  r.  t  i  in  e  o  n  t  s 
Local  r  e  p  1  V  t  i  in  e  o  m  t  s 
Local  bi.iffer  errors 


Some  of  these  counters  can  be  qualified  by  information  that  indicates  the 
condition  that  contributed  to  the  error. 

To  gain  a  detailed  understanding  of  counters  or  the  software  design  and  algor- 
ithms they  represent,  consult  the  appropriate  architectual  specifications.  Re- 
fer to  Chapter  3  for  additional  information  on  the  N'CP  SHOW  commands 
that  display  network  status  and  counter  information. 

Several  counters  in  the  display  above  correspond  to  network  logging  events. 
The  events  and  event  descriptions  may  provide  additional  information  rela- 
tive to  the  specific  occurrence.  Refe-  to  Appendix  D  for  a  complete  description 
of  events  that  can  be  logged.  Appendix  E  maps  individual  counters  to  corre- 
sponding events  where  applicable. 

2.7.2   Zeroing  Counters 

When  the  network  is  running,  you  can  use  the  NCP  ZERO  command  (see 
Chapter  6)  to  zero  any  of  the  network  counters.  It  is  wise  to  zero  counters 
periodically  or  they  will  eventually  exceed  (overflow)  their  maximum  count. 
Counters  that  have  overflowed  display  a  "greater  than"  sign  (>)  in  front  of 
their  maximum  count  (see  the  sample  display,  above). 

For  each  component  there  is  a  special  counter  that  indicates  the  number  of 
seconds  that  have  elapsed  since  the  counters  for  that  component  were  last 
zeroed.  The  software  increments  this  counter  every  second  and  clears  it  when 
other  counters  for  the  component  are  cleared. 
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2.7.3    Counter  Timers  and  Logging  Counters 

For  PSI  lines,  PSI  circuits,  and  PSI  modules,  you  can  use  network  manage- 
ment commands  to  affect  the  frequency  with  which  counters  are  logged  and 
then  automatically  zeroed.  To  set  a  timer  whose  expiration  automatically 
causes  counters  to  be  logged  on  the  logging  component  and  then  to  be  zeroed, 
use  the  COUNTER  TIMER  parameter  with  an  NCPA^NP  SET  CIRCUIT, 
SET  LINE,  or  SET  MODULE  command  (see  Chapter  6).  For  example, 

NCP:SET  LINE  Km;(-0-0  COUNTER  TIMER  GOO 

causes  a  line  counter  logging  event  to  take  place  every  600  seconds  for  line 
KMX-0-0.  To  clear  this  parameter,  use  the  following  NCP  command: 

NCP  Clear  line  kmk-o-o  counter  timer 

This  command  zeroes  the  counter  timer  in  the  volatile  data  base.  You  can  also 
set  and  clear  counter  timers  in  the  permanent  data  base  bv  using  the  CFE 
DEFINE  LINE  and  PURGE  LINE  commands. 

When  counters  are  logged  for  a  particular  component  as  the  result  of  a  counter 
timer  expiration,  event  0.8  is  generated,  followed  by  a  listing  of  the  counters. 

Example: 


Ei'ent  i/pe  0.8  Automatic  counters 
Occurred  G-NOO-83  13:17:43  on  node  5G  (BLTMRE) 
Circuit  OTPOC 

22   Secorids  since  last  zeroed 
0   B  ■/■  t  e  5  r  e  c  e  1  M  e  d 
0   B  y  t  e  s  s  e  n  t 
0   Data  b  1  0  c  K  received 
C)   D  a  t  a  b  1  0  c  K  5  5  e  n  t 
0   L  0  c  a  1  1  v  initiated  resets 
0       R  e  (ti  0  t  e  1  V  initiated  resets 
0   N  e  t  w  0  r  K  initiated  resets 


2.8    Processes 


DECnet-RSX  processes  provide  specific  functions  for  the  DECnet-RSX  sys 
tem.  For  example,  the  ECL  process  controls  logical  link  handling,  while  NW 
controls  X.25  level  3  protocol  operations.  There  are  also  device  driver  pro 
cesses  that  control  communications  devices  for  the  system.  The  RSX  opera 
ting  system  is  unaware  of  these  processes,  except  as  residents  of  partitions  ir. 
system  memory. 

The  following  network  management  commands  (described  in  detail  in  Chap- 
ter 6)  can  be  used  to  manipulate  DECnet-RSX  processes. 


CFE  Commands 

DEFINE  PROCESS 

LIST  PROCESS 


NCP/VNP  Commands 

SET  PROCESS 
CLEAR  PROCESS 
SHOW  PROCESS 


Table  2-9  lists  the  parameters  that  can  be  specified  on  DEFINE  and  SET 
commands. 
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Table  2-9:    Process  Parameters 


Parameter 

DEFINE 

SET 

ALL 

LOrATION 

X 
X 

MAXIMIM  (X)NTR()LI,KRS 

■nunt 

X 

X 

MAXIMIM  LINKS  nu^,^,T 

X 

X 

F'ARTITIO.N  partitionnamr 

X 

STATE 

V 

2.8.1    Process  Identification 

Vou  can  use  network  management  commands  to  moditv  parameters  tor  an 
individual  process  or  (or  all  known  processes.  I'se  the  KN'OVVN  }'H()(^FSSFS 
keyword  to  specify  all  processes  identified  to  the  svstem  durin^^  net  work  ^jienJr- 
ation.  ()  specify  an  individual  process,  use  a  process  name  from  Table  •>-!() 
1  able  L-IO  lists  processes  alphabetically  by  type,  including  device  driver  pro- 
cesses and  software  prot^    ol-related  processes  for  DECnet  and  PSL 

2.8.2    Process  States  and  Loading 

During  network  generation,  the  required  processes  are  set  up  in  the  perma- 
cvc^  L^ll      '"  """"^  ^'^  automatically  loaded  when  vou  execute  an  \('P  SKT 
n    ,         command.  Likewise,  processes  for  lines  and  circuits  are  automati- 
cally loaded  when  you  issue  one  of  the  following  commands: 

CFE    :EFINE    LINJE    linr-id    STATE    ON 
NC^    SET    LINE    !inr-td    ALL 

A  process  remains  in  memory  until  you  clear  the  .system  or  the  process. 

To  load  a  process  that  has  not  been  automaticallv  loaded  into  the  volatile 
data  base,  u.se  the  XCP  SET  PROCESS  ALL  command.  This  loads  the  iden- 
tified process  with  the  default  inf<.rmation  specified  in  the  permanent  data 
oase  for  each  process  parameter. 

The  LOCATION  parameter  allows  you  to  specify  the  memorv  location  into 
which  to  load  each  process  when  it  is  manually  loaded  into  the  volatile  data 
base.  Ihis  enables  you  to  manage  memory  allocation  tor  the  system. 

2.8.3    Maximum  Controllers  and  Lines 

During  network  generation,  you  specify  the  maximum  number  of  lines  and 

Ml  M  (  ON  IROLLKRS  and  MAXLMl'M  LINES  parameters  to  modifv  this 
information.   I  hese  parameters  determine  the  amount  of  additional  space  to 
be  reserved  in  the  proce.ss  partition  that  is  used  to  allocate  process  tables   If 
rriore  lines  are   oaded  than  specified  by  the  MAXIMl'M  LINES  parameter 
the  additional  line  tables  are  allocated  from  the  svstem  pool 
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Table  2-10:    DECnet-RSX  Processes 


Process  Nam« 

Communications  Executive 
AIX 

DIA 
F.VL 

DECnet  device  drivers 

I)L 

DI.V 

DMC 

DMF' 

DMV 

DPV 

nr 

mv 
\n\- 

l)V 

I)Z 

nzv 

KDP  iKM(^I)rp) 

KDZ(KMC,T)Z) 

VVL 

INA 

QNA 

OECnet  processes 

DCP 

p:pm 

ECL 

XPT 

PS!  device  drivers 
KMX 

SDP 

SDV 

PSI  processes 

DLM 

LAB 
NW 

PLI 


Function 

processes 

Auxiliary  process 

Direct  Line  Access  ^'ontrcller 

Kvent  Logger  process 

I)L  11  driver 

DIA'   11  driver 

DMC   llDMH   11  driver 

DMP  11  driver 

DM^     II  f'-iver 

DPV   11  driver 

DL   11  driver 

DIP  11  driver 

DLV   11  driver 

DV   11  driver 

DZ  11  driver 

DZV  11  driver 

KDP  11  driver 

KDZ-11  driver 

PCL  driver 

DEl'NA  driver 

DP:QNA  driver 

Implements  DDCMP;  included  for  all  systems  with  de- 
vices other  than  DMC  1 1.  DMP  11.  DMR  11,  DMV  11. 
PCL- 11 B,  DP:rNA.  and  DEQNA 

Ethernet  Protocol  Manager;  included  lor  all  systems 
with  Ethernet  devices 

F^nd  Communications  layer  process 

Transport  layer  process 

KMX -11  driver 
DUP-11  driver 
DPV- 11  driver 

Data-link-mappinp  process 

X.25  level  2  LAPB  protocol  process 

PSI  user  interface  process 

X.25  level  M  (packet  level)  process 


• 
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2.9    PSI  Modules 


There  are  (our  PSI  modules  that  can  be  manipulated  by  DKCnet  HSX  net- 
work management  commands: 

•  X.25  protocol  module.  Identifies  local  DTFl  addresses  and  group  names 

•  X.25  server  module  and  X.29  server  module.  Identitits  destinations 

•  X.25  access  module.  Replaces  remote  DTE  addresses  with  logical  destina- 
tion names 

Each  module,  its  function,  and  its  parameters  are  brielly  described  in  the 
Ibllowing  sections.  For  full  details,  see  the  applicable  SETDEFINE, 
(T.F^AR/PrROF].  and  SHOW/LIST  command  descriptions  in  Chapter  i\ 

2.9.1    X.25  Protocol  Module 

The  \:2r)  protocol  module  implements  the  X.2")  level  .'^  protocol  that  controls 
the  transmission  of  data  packets.  In  particular,  this  module  structures  control 
and  user  data  into  packets:  .sequences  these  packets  tor  transmission:  and 
establishes,  maintains,  and  clears  PSI  virtual  circuits.  This  module  also  asso- 
ciates local  DTE  addresses  and  group  names  with  this  controlling  informa- 
tion. 

Table  2-11  lists  the  three  types  of  X.2")  protocol  parameters  that  can  be 
specified  in  DEFINE  and  SET  commands.  P^ach  type  is  briefly  discussed  in 
the  following  sections.  For  more  information  on  parameters  for  DF^P'INP'/SET 
MODILE  X25-PROTOrOL  commands,  see  (^hapter  6. 

2.9.1.1  Protocol-related  Parameters  —  During  network  generation,  you  speci- 
fied a  number  of  protocol-related  parameters  that  affect  the  operation  of  the 
X.25  protocol  module.  These  parameters  can  be  modified  only  in  the  perma- 
nent data  base. 

Both  the  packet  and  window  size  parameters  were  set  to  defaults  for  the  PSN 
to  which  the  DTE  is  connected.  Consult  the  RSX-11  PSI  Xctuorh-sprcific 
Information  manual  for  details  of  these  values  before  modifying  them. 

When  you  u.se  the  MAXIMl'M  DATA  parameter  to  specify  the  maximum 
size  of  a  packet  for  all  SVCs.  specify  a  size  at  least  5  bytes  smaller  than  the 
maximum  size  specified  for  a  frame  on  a  line  (see  DEFINE]  LINE  in  Chapter 
6).  This  value  must  not  be  exceeded  when  you  specify  a  companion  value  for 
the  DEFAULT  DATA  parameter.  For  complete  descriptions  of  all  protocol- 
related  parameters,  see  Chapter  6. 


2.9.1.2  Local  DTE-related  Parameters  —  Every  DTE  in  the  network  is  identi- 
fied by  one  or  more  local  DTP]  addresses.  You  can  use  network  management 
commands  to  modify  parameters  for  a  specific  DTE  or  for  all  known  DTP^s. 
Use  the  KNOWN  DTES  keyword  to  modify  parameters  for  all  lf)cal  DTEs 
identified  to  the  system  during  network  generation.  To  modify  parameters  for 
a  specific  DTE.  use  the  DTE  keyword  with  an  integer  address  consisting  of  1 
to  15  digits. 
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Table  2-11:    Protocol  Module  Parameters 


Parameter  DEFINE 

Protocol-ralatad  parameters 

MAXIMUM  DATA  X 

DEFAILT  DATA  X 

MAXIMl'M  WINDOW  X 

DEFAILT  WINDOW  X 

CALL  TIMER  X 

CLEAR  TIMER  X 

MAXIMUM  CLEARS  X 

RESET  TIMER  X 

MAXIMUM  RESETS  X 

RESTART  TIMER  X 

MAXIMUM  RESTARTS  X 
Local  DTE-related  parameters 

DTE  X 

COUNTER  TIMER  X 

STATE  X 

LINE  X 

MAXIMUM  CIRCUITS  X 

CHANNELS  X 
Group-related  parameters 

GROUP  X 

DTE  X 

NUMBER  X 

TYPE  BILATERAL  X 


SET 


X 
X 
X 


X 
X 
X 
X 


2.9.1.3  Group-related  Parameters  —  At  subscription  time,  you  may  have 
chosen  an  optional  user  group  facility  to  restrict  DTE  communication.  You 
can  use  network  management  commands  to  modify  parameters  for  a  specific 
group  or  for  all  known  groups.  Use  the  KNOWN  GROUPS  keyword  to  modify 
parameters  for  all  groups  identified  to  the  system  during  network  generation. 
To  modify  parameters  for  a  specific  group,  use  the  GROUP  keyword  with  a 
group  name  consisting  of  1  to  6  alphanumeric  characters.  Every  group  name 
must  in  turn  be  associated  with  a  local  DTE  address.  Use  the  NUMBER 
parameter  to  modify  the  group  number  allocated  at  subscription  time. 
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2.9.2    X.25  Server  and  X.29  Server  Modules 

Whenever  a  remote  DTE  attempts  to  communicate  with  vour  local  DTE  (that 
IS.  attempts  to  set  up  a  virtual  circuit),  both  the  remote  DTE  and  the  system 
manager  at  the  local  DTE  provide  information  that  identifies  the  destination 
ot  the  call.  This  mformation  consists  of  the  remote  DTE  address  a  local  DTE 
fp^7,!!'  P«ss»bl>'  a  closed  user  group  (CUG)  or  bilateral  closed  user  group 
BCIG)  name,  and  possibly  a  value  in  the  user  data  field.  DECnet-RSX 
software  uses  this  information  to  determine  how  to  handle  the  incoming  call 
to  the  local  DTE. 

How  the  software  handles  incoming  calls  depends  upon  the  parameters  you 
define  for  X.25  server  and  X.29  server  module  destinations.  The  software  uses 
X.2o  server  module  parameters  to  handle  incoming  calls  for  the  PSI  user 
program  interface.  It  uses  X.29  server  module  parameters  to  handle  incoming 
calls  tor  the  PSI  X.29  terminal  interface.  For  information  on  incoming  call 
handling  for  DECnet-RSX  with  a  PSI  capabilitv.  see  the  RSX-11  PSI  Sx.tem 
Af onager's  Guide. 

Smer  module  parameters  consist  of  two  types:  server-related  parameters 
which  affect  the  operation  of  the  server  software,  and  destination-related 
parameters,  which  define  information  for  handling  incoming  calls. 

nt^i!fx^c>^^  ^'f""  ^''  ^^'^^  ^^^  ""^^'^^  """"^"'^  parameters  that  can  be  specified  in 
UEUXE  and  SET  commands.  For  more  information,  see  DEFINE/SET  com- 
mand descriptions  in  Chapter  6. 

Table  2-12:    Server  Module  Parameters 


Parameter 

Server-related  parameters 

COUNTER  TIMER 
STATE  (1) 

MAXIMUM  CIRCUITS 
Destination-related  parameters 

DESTINATION- 
CALL  MASK 
CALL  VALUE  (2) 
GROUP  (3) 
NUMBER 
SUBADDRESSES 
OBJECT  (4) 
PRIORITY 


DEFINE         SET 

X  X 

X 


X 
X 
X 
X 
X 
X 
X 
X 


X 
X 
X 
X 
X 
X 
X 
X 


1.  Vou  cannot  specify  STATE  for  the  x.29  server  module. 

2.  A  value  of  01  is  recommended  for  the  X.29  server  module. 

3.  This  group  name  must  match  the  one  specified  in  the  protocol  module 

4.  Specify  a  task  number  for  X.25  multicopy  ta.sks  and  a  task  name  for  X.29  destinations. 
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2.9.2.1  Destination-related  Parameters—  You  can  use  network  management 
commands  to  modity  parameters  tor  a  specilic  destination  or  (or  all  known 
destinatic^ns.  I'se  the  KNOWN  DESTINATIONS  keyword  to  moditv  parame- 
ters tor  all  destinations  identified  to  the  system  during  network  generation.  To 
modify  parameters  for  a  specific  destination,  use  the  DESTINATION  key- 
word with  a  destination  name  consisting  of  1  to  B  alphanumeric  characters. 

There  are  five  destination  parameters  that  you  can  modify  to  .set  up  incoming 
call  specifications.  Two  other  parameters  specify  the  priority  of  the  deslina'^ 
tion  and  the  task  (object)  to  which  the  destination  passes  the  call  for  process- 
ing. 


NOTE 

You  cannot  modify  parameters  for  existing  destinations.  You 
can  only  create  new  destinations.  Existing  destinations  can  be 
cleared,  then  reset  with  new  parameters.  If  you  specify  a  desti- 
nation name,  you  must  al.so  specify  the  object. 

2.9  2.2  Server.related  Parameters  —  During  network  generation,  vou  speci- 
fied the  maximum  number  of  circuits  that  each  server  module  could  handle 
simultaneously  (including  both  incoming  and  outgoing  calls).  This  count  can 
be  modified  in  the  permanent  data  base  by  specifying  the  MAXIMUM  CIR- 
CUITS parameter. 

In  the  volatile  data  ba.se.  you  can  set  the  X.25  server  module  state  to  one  of 
the  following  values: 


OFF 

ON 
SHUT 


Allows  no  virtual  circuit  activity,  terminates  existing  circuits,  and 
forces  the  relea.se  of  all  mailboxes  immediately. 

Allows  normal  virtual  circuit  activity. 

Allows  no  new  virtual  circuits,  does  not  destroy  existing  virtual  cir- 
cuits, and  goes  to  the  OFF  state  when  all  virtual  circuits  terminate 
and  all  mailboxes  are  released. 


2.9.3    X.25  Access  Module 

You  can  use  the  X.25  access  module  to  create  PSI  logical  de.stination  names  to 
use  like  alias  node  names  (see  Section  2.1.1.2)  in  place  of  a  remote  DTE 
address  whenever  you  identify  a  remote  DTE  in  a  PSX.  RSX-11  PSI  software 
han.Jes  the  translation  from  logical  destination  name  to  remote  DTE  address. 
\ou  can  create  or  modify  logical  destination  names  in  anv  of  the  three  data 
bases.  For  example,  to  create  a  logical  destination  name  in  the  volatile  data 
base,  use  the  NCP  SET  MODULE  X25-ACCESS  command: 

NCP  SET  MODULE  X25-ACCESS  DESTINATION  STE-E  NUMBER  1235G  TEfyMlNAL  TTU 
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This  command  specifies  that  logical  destination  name  S'I'FAK  can  be  used  in 
place  of  remote  DTK  numher  12;l")(i  for  network  user  programs  initiated  from 
terminal  TTl  1:.  You  can  specify  whether  the  logical  destination  name  applies 
to  a  specific  terminal  (TKHMIXAL  trrm-id),  as  in  this  example,  or  to  all 
teririnals  ((GLOBAL).  The  default  scope  is  your  terminal. 

^ee  the  SETTIKFIXE.  rLKAR/PlHOK.  and  .SHOW  LIST  MODILK 
X2ri-A(X'KSS  command  descriptions  in  (^hapter  H  for  full  details  on  i)arame- 
ters  and  usage. 

2.9.4    PSI  Module  Counters 

RSX-ll  FSI  automatically  maintains  certain  statistics,  called  counters,  in 
the  network  for  the  X.2o  protocol.  X.25  server,  and  X.29  server  modules.  For 
the  X.2o  protocol  module,  these  counters  include  the  number  of  bytes,  data 
blocks,  calls,  and  last  selects  sent  and  received:  the  number  of  active  chan- 
nels: the  number  of  resets  sent,  received,  or  initiated  by  the  network:  and  the 
number  of  restarts.  These  statistics  are  u.seful  in  monitoring  the  activity  of  the 
component.  X.2.VX.29  server  module  counters  include  the  maximum  number 
of  active  circuits,  the  number  of  incoming  calls  rejected,  the  time  since  the 
counter  was  last  zeroed,  and  a  counter  timer  value.  See  Appendix  E  for  a 
complete  list  of  all  PSI  module  counters. 
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Chapter  3 

Operating  DECnet-RSX/PSI  Nodes 


This  chapter  provides  the  basic  information  vou  need  to  perform  the  follow 
iunctions: 


ing 


3.1 


•  Start  up  and  shut  down  a  local  DF:Cnet-RSX  node  (see  Section  :].{) 

•  Start  up  and  shut  down  a  local  DECnet  RSX/PSl  node  (see  Section  :12) 

•  Monitor  local  and  remote  nodes  within  a  DKCnet-RSX/RSI  network  (see 
Section  3.3) 

•  Test  network  operation  (see  Section  3.4) 

Specific  CFK.  \CP.  and  VXP  commands  are  referenced  throughout  this 
chapter.  See  Chapter  6  for  more  information  on  using  these  commands  and 
their  parameters. 

Starting  Up/Shutting  Down  a  Local  DECnet-RSX  Node 

3.1.1    Starting  Up  a  Local  DECnet-RSX  Node 

The  start-up  procedure  for  a  local  node  loads  the  Communications  Executive 
(C  hX)  into  memory  and  activates  the  DECnet-RSX  software   If  vour  DEC 
net  system  includes  PSI.  PSI  is  automatically  loaded,  hut  vou  must  still  start 
It  up  (see  Section  3.2.1). 

To  load  the  DECnet  software  into  the  volatile  data  base,  use  <,ne  of  the 
toUowing  methods: 

•  The  \ETIXS.CMD  file  (for  newly  generated  systems* 

•  NCP  commands  (for  previously  installed  .software) 

•  V\P  commands  (to  reboot  from  the  system  image  file;  not  supported  bv 
bECnet-llM-PLlS) 

For  more  information  on  using  the  XCP  and  VXP  utilities,  see  Chapter  1. 
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3.1.1.1  Using  the  NETINS.CMD  File  -  The  NKTIXS.CMD  file  is  a  product  <.t 
NKTdKN  and  is  described  in  detail  in  the  DFA'rwt  RSX  W'tuork  (inwratum 
and  ^  Installation  Cuicir.  After  running  \KT(;KN.  you  must  use 
NKTINS.(^MI)  to  start  i  newly  generated  DKCnet-RSX  system  for  the 

tirst  time.  To  load  a  DKC'nei  KSX  system  using  this  file,  enter 

(?[  Mv  .  1  INETINS 

where  .v.i.v  is  the  network  IK^  group  code  selected  at  NP:T(;KN. 


3.1.1.2  Using  NCP  Commands  —  I'se  the  following  .\(T  commands  to  load 
and  start  up  a  DHC^net  K.SX  system  when  the  network  software  has  already 
been  installed  (by  a  previous  run  of  XKTIXS.CMI).  for  example). 


NCP     SE^     SYSTEM 

NCP  SET  e;;ecutor  state  on 


3.1.1.3  Using  VNP  Commands—  I'se  the  following  VXP  commands  to  incor- 
porate the  DEC'net  R.SX  software  components  into  the  KSX  llM  or 
HSX-llS  system  image  file  (RSX-llM  FLl'S  does  not  support  VXP).  Vou 
must  perform  an  KSX  .SAV  on  the  system  image  file  before  vou  run  \'XF 
Once  you  have  run  VXP.  DECnet-R.SX  will  start  up  automaticallv  the  next 
time  you  boot  the  RSX  operating  system. 


>i.'NP 

E  ri  t  e  r  f  1  1  e  r,  a  m  e  :  Ty  S  ;<  1  1  S  SYS 

'.'  N  P  5  E  T  5  V  5  T  E  ,1 

VNP  SET  EXECUTOR  STATE  ON 


(or   RSXllM.SVS) 


3.1.2    Loading/Turning  On  a  Line  in  a  Running  System 

After  you  have  started  up  the  system,  you  can  still  load  a  line  (or  all  lines 
known  to  the  system)  and  turn  on  the  associated  circuit(s)  bv  issuing  one  of 
the  following  pairs  of  commands: 

NCP    BET    L  INE    linv-id    ALL 

NCP    SET    CirvCUIT    vircuit-ia    STATE     ON  . 

NCP  SET  KNOWN  LINES  ALL 

NCP-SET  KNOWN  CirvCUITS  STATE  ON 


Al!  lines  to  be  loaded  must  be  in  the  CLEARED  state.  The  ALL  paramet-r 
specifies  that  the  line(s)  are  to  be  loaded  with  the  default  parameter  values 
spec.fied  in  the  permanent  data  base.  If  vou  wish  to  change  the  defaults  you 
must  specify  the  appropriate  SET  LLXE  command  parameters  (see  Chapter  6 
for  details). 

To  cause  a  new  line  (or  all  known  lines)  to  be  loaded  and  turned  on  the  next 
time  the  system  is  started  up.  use  the  CFE  DEFLXE  versions  of  the  com- 
mands shown  above  to  set  up  the  line(s)  and  circuit(s)  in  the  permanent  data 
base.  The  line(s)  will  be  automatically  loaded  and  their  circuit(s)  turned  on 
the  next  time  you  issue  the  SET  SYSTEM  and  SET  EXECITOR  STATE 
ON  commands. 
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3.1.3    Shutting  Down  DECnet-RSX 

You  can  slmt  dovn  selected  lines  or  the  entire  node,  as  described  in  the 
following  sections. 


3.1.3.1  Shutting  Down  DECnet-RSX  Lines  —  You  shut  down  a  DFCnet  line  by 
setting  the  state  of  the  associated  circuit  to  OFF.  You  can  shut  down  one  or  ail 
DECnet  lines  by  usmg  one  of  the  following  commands: 


NCP>5ET  cir^r;.  :  •   .■,;,;•  ,^  _,'.,- r  ,y,', 
NCP:-SF^  -  .OWN  CIRCuHS  STATE  OFF 


3.1.3.2  Shutting  Down  a  DECnet-RSX  Node  —  Ise  the  NTP  SFT  KXF(  U- 
TOR  STATE  command  to  shut  down  node  activity  immediately  or  in  an 
orderly  fashion,  depending  upon  the  state  you  specify. 

State     Result 

SHIT  Orderly  shutdown.  Prevents  any  new  l..gual  links  tc  nr  tr-'m  the  node,  hut  dees  not 
cut  oti  currently  active  links.  After  all  link>  have  disconnected,  the  system  returns 
event  message  2.0.  stating  that  the  executor  state  is  OFF. 

OFF  Immediate  shutdown.  Immediately  terminates  all  network  activitv  without  allowing: 
active  links  to  disconnect  in  an  orderly  manner. 

You  can  also  initiate  the  orderly  shutdown  of  a  DECnet  RSX  node  by  execut- 
ing the  following  XETGEX  output  command  tile: 


• 


where  xxx  is  the  network  I'lC  group  code  selected  at  XETGEX.  For  more 
information,  see  the  DKCnrt-RSX  Xrtuork  (ivncratum  and  Instnllatinn 
Guide. 

3.2   Starting  Up/Shutting  Down  a  Local  DECnet-RSX/PSI  Node 

3.2.1    Starting  Up  a  Local  DECnet-RSX/PSI  Node 

The  start-up  procedure  for  a  local  node  loads  the  Communications  E.xecutive 
(CEX)  into  memory  and  activates  the  DECnet-RSX  software.  F^SI  is  auto- 
matically loaded,  but  you  still  have  to  start  it  up. 

To  load  the  DECnet  software  into  the  volatile  data  ba.se.  use  one  of  the 
following  methods: 

•  The  XETIXS.CMD  file  (for  newly  generated  .systems) 

•  XCP  commands  (for  previously  installed  software) 

•  VXP  com.mands  (to  reboot  from  the  r,vstem  image  file:  not  supported  bv 
DECnet-UM-PLl'S) 

For  more  information  on  using  the  XCP  and  VXP  utilities,  see  Chapter  1. 
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3.2.1.1  Using  the  NETINS.CMD  File  —  The  NETINS.CMD  file  is  a  product  of 
NETGEN  and  is  described  in  detail  in  the  DtTrwt-RSX  Sctwnrh  feneration 
and  Installation  Guide.  After  running  NETGEN,  you  must  use 
NETINS.CMD  to  start  up  a  newly  generated  DECnet  RSX/PSI  system  for 
the  first  time.  To  load  a  DECnet-RS\/I\SI  system  using  this  file,  enter 

>(?[.vvr  .  1  ]NET  INS 


where  xxx  is  the  network  ITC  group  code  selected  at  NETGEN. 

3.2.1.2  Using  NCP  Commands  —  Tse  the  following  NCP  commands  to  load 
and  start  up  a  DECnet-RSX/PSI  system  when  the  network  software  has 
already  been  installed  (by  a  previous  run  of  NETINS.CMD,  for  example). 

NCP>5ET  SYSTEM 

NCP  -SET  EXECUTOry  STATE  ON 

NCP:SET  MODULE  X25  -  SERi.'Ery  STATE 


ON 


3.2.1.3  Using  VNP  Commands  —  Use  the  following  VNP  commands  to  incor- 
porate the  DECnet-RSX/PSI  software  components  into  the  RSX-UM  or 
RSX-US  system  image  file  (RSX-llM-PLUS  does  not  support  VNP).  You 
must  perform  an  RSX  SA\'  on  the  system  image  file  before  you  run  VNP 
Once  you  have  run  VNP.  DECnet-RSX/PSI  will  start  up  automatically  the 
next  time  you  boot  the  RSX  operating  system. 


'■> '.'  N  ^ 

Enter  filename:  R  S  )<  1  1  S  .  5  i'  5 
'.'NP-^SET  SYSTEM 
'.'NP:5ET  EXECUTOry  STATE  ON 
'.'NP-5ET  MODJLE  >;25  -  SETyVETy  STATE 


(or  RSXllM.SYS) 


ON 


3.2.2    Loading/Turning  On  a  PSI  Line  in  a  Running  System 

After  you  have  started  up  the  system,  you  can  still  load  and  turn  on  a  specific 
PSI  line  or  all  PSI  lines  known  to  the  svstem  by  issuing  one  of  the  following 
commands: 

NCP  SET  LINE  linv-id    ALL  STATE  ON 
NCP  SET  KNOWN  LINES  ALL  STATE  ON 

All  lines  to  be  loaded  must  be  in  the  CLEARED  state.  The  ALL  parameter 
specifies  that  the  line(s)  are  to  be  loaded  with  the  default  parameter  values.  If 
you  wish  to  change  the  defaults,  you  must  specify  the  appropriate  SET  LINE 
command  parameters  (see  Chapter  6  for  details). 

To  cause  a  new  line  (or  all  known  lines)  to  be  loaded  and  turned  on  the  next 
time  the  system  is  started  up,  use  the  CFE  DEFINE  versions  of  the  com- 
mands shown  above  to  set  up  the  line(s)  in  the  permanent  data  base.  The 
line(s)  will  be  automatically  loaded  and  turned  on  the  next  time  you  issue  the 
SET  SYSTEM  and  SET  MODULE  X25-SERVER  STATE  ON  commands 
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3.2.3    Shutting  Down  PSI 

You  can  shut  down  selected  PSI  components  or  the  whole  PSI  module,  as 
described  in  the  following  sections. 

3.2.3.1    Shutting  Down  PSI  Components  ~  To  shut  down  one  or  all  PSI  lines, 
use  one  of  the  following  commands: 

NCP>5ET  LINE  lirw-id    STATE  OFF 
NCP>SET  KNOWN  LINES  STATE  OFF 

To  shut  down  one  or  all  DTEs,  use  one  of  the  following  commands: 

NCP:>SET  MODULE  KZ?  -  PROTOCOL  DTE  cit^'-addrcss    STATE  SHUT 
NCP>SET  MODULE  M:?-PR0T0CGL  KNOWN  DTES  STATE  SHUT 

The  system  will  eventually  return  an  event  message  saving  that  the  specified 
DTE(s)  have  been  shut  down. 

3.2.3.2  Shutting  Down  a  PSI  Module  —  Use  the  NCP  SET  MODULE 
X25-SERVER  STATE  command  to  shut  down  PSI  immediatelv  or  in  an 
orderly  tashion,  depending  upon  the  state  you  specify. 

State     Result 

SHIT  Orderly  shutdown.  Prevents  any  new  virtual  circuit  connections  to  the  module  but 
does  not  cut  off  current  connections.  After  all  virtual  circuits  have  disconnected,  the 
system  returns  an  event  message  stating  that  the  module  state  is  OFF. 

OFF  Immediate  shutdown.  Immediately  terminates  all  virtual  circuit  connections  without 
allowmg  circuits  to  disconnect  in  an  orderly  manner. 

When  PSI  operation  has  ceased,  you  can  then  shut  down  DECnet-RSX  on  the 
local  node  (see  Section  3.1.3.2). 


3.3    Monitoring  DECnet-RSX/PSI  Nodes 


DECnet  provides  several  means  of  monitoring  network  activitv  once  you  have 
brought  up  the  local  DECnet  system. 

•  You  can  use  CFE,  NCP,  or  VNP  commands  to  displav  information  about 
network  components. 

•  You  can  use  the  Event  Logger  (EVL)  to  log  dynamic  network  events. 

•  You  can  use  the  Network  Display  Program  (NTD)  to  displav  reachable 
nodes  or  a  specific  node's  resources. 

This  section  provides  an  overview  of  each  of  these  facilities. 
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3.3.1    NCP,  VNP,  and  CFE  Display  Commands 

NTP,  VNP.  and  CFE  provide  co  'mands  that  enable  you  to  display  intbrma- 
tion  about  network  components  on  your  terminal. 

•  The  NTP  SHOW  command  displays  component  information  fnmi  the  vola- 
tile data  base.  For  example,  it  a  line  failure  or  a  change  of  .state  on  a  line  or 
circuit  occurs  on  a  routing  node,  you  can  issue  an  NCP  SHOW  ACTIVE 
NODES  command  to  determine  which  known  nodes  are  now  reachable. 
Depending  on  the  component  specified,  you  can  select  from  the  following 
types  of  display: 

CHARACTERISTICS  displays  static  information  about  the  component, 
such  as  the  local  node  identification  and  relevant  routing  parameters  (for 
the  EXECUTOR  component)  or  the  names  and  numbers  of  known  network 
objects. 

COCNTERS  provides  counter  information  for  circuits,  modules,  lines, 
nodes,  and  the  system.  (See  Chapter  2  for  a  discu.ssicm  of  counters.) 

EVENTS  (SHOW  LOGGING  only)  displays  information  about  events  cur- 
rently being  logged. 

vSTATUS  shows  dynamic  information  that  usually  reflects  network  activity 
for  the  running  network.  Depending  on  the  component,  this  can  include  the 
local  node  and  its  operational  state,  reachable  and  unreachable  nodes,  the 
local  DTE  and  its  operational  state,  and  circuits  and  lines  and  their  opera- 
tional states. 

SUMMARY  (default)  includes  only  the  most  useful  information  derived 
from  both  static  and  dynamic  sources.  This  is  usuallv  an  abbreviated  list  of 
information  provided  for  both  the  CHARACTERISTICS  and  STATUS  dis- 
play types. 

•  The  VNP  SHOW  command  displays  component  information  from  the  sys- 
tem image  file.  Depending  on  the  component,  vou  can  choose  a  CHARAC- 
TERISTICS. EVENTS,  or  SUMMARY  (default)  display  type.  See  the  defi- 
nitions of  these  display  types  given  above. 

•  The  CFE  LIST  command  automatically  displays  static  information  for  the 
specified  component  (see  the  description  of  CHARACTERISTICS  above). 


Chapter  6  describes  the  display  commands  for  all  three  utilit 


les. 
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3.3.1.1    Network  Components-   The  components  tor  which  vou  can  (lis)lav 
intormation  are: 

•  .Aliases 

•  Circuits 

•  Lines 

•  Logging 

•  Modules 

•  Nodes,  including  the  executor  node 

•  Objects 

•  Processes 

•  System 

•  Trace 

In  most  cases  you  can  display  intormation  lor  one  i)articular  component  (lor 
example,  tor  LINE  D.MC-O)  or  tor  all  components  of  the  specified  tvpe  that 
lall  withm  one  ot  several  group  classifications.  The  group  classifications  that 
you  can  specify  are: 

•  KXOVVN  -  Displays  information  for  all  instances  of  a  component  available 
to  the  local  node;  for  example. 

NCP  SHOW  KNOWN  NODES  CHARACTERISTICS 

•  SIGNIFICANT  -  Shows  information  about  all  instances  of  a  known  com- 
ponent tor  which  information  is  available;  for  example, 

NCP.  ^mOW  SIGNIFICANT  LINES 

•  ACTIVE  —  Displays  information  for  all  active  components  (that  is  those 
components  whose  state  is  other  than  OFF  or  CLEARED);  for  example, 

NCP>SHOW  ACTIVE  LINES  CHARACTERISTICS 

•  ALL  (valid  only  for  NCPA'NP  SHOW  ALIAS  and  SHOW  MODULE 
X20-ACCESS  commands)  -  Displays  information  for  all  aliases  or  logical 
destination  names  regardless  of  scope;  for  example, 

NCP>SHOW  ALL  ALIASES 

See  SHOW  command  descriptions  in  Chapter  6  to  determine  which  classitlca- 
tions  apply  to  each  component. 
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3.3.1  2  Copying  NCP  Display  Information  to  a  File  -  All  N(  P  display  com- 
mands optionally  allow  you  to  direct  the  display  information  to  a  user-speci- 
tied  output  (lie  mstead  of  displaying  it  on  your  terminal.  If  the  specified  file 
already  exists.  NCP  appends  the  display  information  to  the  file. 

Example: 


NCP    :mjw    known    logging    to    NET. LOG 


This  example  creates  the  file  NET.LOC;  (under  the  current  VIC),  which  will 
contain  current  summary  information  for  all  known  logginK  on  the  running 
network. 


3.3.1.3    NCP  SHOW  Command  Examples  — 

yarious  NCP  SHOW  command  displays. 

Example  1: 


The  following  examples  illustrate 


NCP  SHOW  EXECUTOrv  CHAfy AC TEfy  I  ST  I  C5 

No.je  ch  a  ra-  •  ensues  as  of  13-5EP-83  1G:29:30 

Eyecutor  node  =  19  (BUTyGETy) 

Identification  =  DISTfylBUTED  SYSTEMS.  Management  version  =  a.n    n 

Host  -     19  (BUryGEfy).  Loop  count  1.  Loop  length  =  ao 

Loop  u.  i  t  h  =  Mixed.  NSP  -ersion  =  a.n.u 

Maximum  linKs  =  20,    Ty  o  u  t  I  n  3  ugrsioi 

P  0  u  t  1  r,  3  timer  =  3  0  0 

MaKimuiTi  address  =  300.  Manimu 

M  a  X  1  m  u  (ti  cost  =  1 1.)  2  Z 

Maximum  Hops  =  10.  Maximum  -isits  =  20 

M  a  H  1  -T.  u  m    t.  r  0  a  d  c  a  s  t     r,  o  n  r  o  ..a  e  r  b     -     3  2 

M  a  K  1  (Ti  u  IT)    broadcast     routers    =     15 

■^  r  a  r,  5  m  1  t    password    =     ... 

'.'  e  r  1  f  1  c  a  1 1  0  n    s  t  a  t  e    =    0  n 


'"I    =     2  .  0  .  (J  .    T  V  p  e     =    ly  0  u  t  i  ri  g     I  0 
u  (Ti    c  1  r  c  M  1  t  s    =    8 


Example  2: 

NCP    SHOW    KNOWN    LINES 

K  n  0  ui  r,     1  1  r,  e  5     s  u  (»i  ft\  a  r  v     as    of     1  3  -  S  E  P  -  8  3    16:32 

State 


3^ 


L  1  I'l  e 

D  M  C  -  C) 
DMC-  1 
PCL-0 
UNA-0 
UNA-1 


On 

Cleared 

On 

On 

Cleared 
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Example  3: 

Line    characteristics    as    of     13-5EP-8J    IG: 38:06 
L  1  i-t  e     =     U  N  A  -  0 

Cor,  troller     =    Noritial 

Protocol  =  Ether  r.  et 

Hardware  address  =  A  A  -  (j  o  - 1;)  3  _  j  0  -  c.)  1  - 1  3 

Controller  CSfy  =  17^510.  '.'ector  =  120.  Prior  it 


Example  4: 


N C  P  "  H G  U  L  I  N F  PC  I 


L  1  ri  e  =  P  C  L  -  i.'i 


1882i:  Seconds    s  i -.  c  e     last    :eroed 

0  A  1 1  e  iT^  p  t  s     to    b  e  c  0  fri  e    (taster 

0  Process    errors 

0  Cei'ice    errors 


Example  5: 


NCP  SHOW  CIRCUIT  PCI    .:   ......  -.  .;:tt'' 

Circuit  characteristics  as  of  U- SEP -83  10:02:^7 
C  1  r  c  u  1  t  =  P  C  L  -  0  .  2 


Cost 
0  w  '"I  e  r 
'''  V  p  e 


2.  Hello  timer  =  15.  Listen  timer  =  3n 
,;PT 

D  D  C  M  P  C  0  .-,  t  r  0  1  1  e  r  .  T  r  1 1'  'j  t  a  r  /  -    3 


Example  6: 


NCP  SHOW  KNOWN  OBJECTS 

Known  objects  sumr-iar/  as  of  13-SEP-83  1G:39:18 

Object   Name     CoPies   User      '.' e  r  i  f  i  c  a  t  i  o  n 


(.) 

15 

IG 

17 

18 

13 

23 

25 

26 

B3 


TCL. . . 
LSN$$$ 
FAL$$$ 
HLD.  .  . 
NIC$$$ 
RMHACP 

MI  rv  $  $  $ 

E'.'R.  .  . 
D  T  .f-v  .  .  . 


S  1  i-i  s  1  e 
Single 

5 

3 

5  1  i-i  3  1  e 

S  1  r.  s  1  e 

S  1  ri  3  1  e 
S  1  fi  g  1  e 


Default 

D  e  f  a  i.i  1  t 

Default 

L  0  3  1  ri 

Default 

D  e  f  a  u  1  t 

Default 

Default 

Default 

Default 


Off 

On 

Off 

On 

Off 

I  ''i  s  p  e  c  t 

Off 

Of  f 

Off 

Of  f 


• 
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3.3.2    Event  Logging 

Event  loKKing  allows  you  to  monitor  selected  network  activity  that  might 
otherwise  go  unobserved.  The  events  that  can  he  logged  include  those  occur- 
ring at  the  local  node  and  at  remote  DTKs.  Heter  to  Chapter  2  tor  a  general 
overview  of  event  logging. 

The  tollcwing  network  management  commands  control  event  logging  (see 
Chapter  H  (or  details): 


CFE  Commands 

DKKINK  LOdCINf; 

in  HCK  L()(i(;i\(; 
Lis'i-  i.()(;(;iN(; 


NCP  VNP  Commands 

SKT  !.()(;( ;iN(; 

SHOW  !,()(;( iINO 


A  simple  example  of  how  you  can  use  event -logging  commands  to  monitor 
local  and  remote  nodes  in  your  network  is  shown  below.  This  sequence  ofXCP 
commands  sets  up  event  logging  tor  a  local  node  called  ALB  and  tor  two 
remote  nodes  called  PHI.  and  BOS.  In  response  to  the  first  command,  ALB's 
system  console  will  display  all  known  events  that  occur  locally.  In  resp;mse  to 
the  next  tour  commands,  remote  nodes  BOS  and  PHL  will  each  log  all  known 
events  locally  at  the  system  console  and  remotely  at  node  ALB's  system 
console. 


NCP  rF^  wOGGING  CONSOLE  KNOWN  EViINTc  sjATE  ON 

NCP  '•:._  BOS  SET  LOGGING  CONSOLE  Kr^OWN  EVENTS  STATE  ON 

NCP  TELL  BOS  SET  LOGGING  CONSOLE  SINK  NODE  AlB  KNOWN  E'.'ENTS 

NCP  TELL  PML  SET  LOGGING  CONSOLE  KNHWN  EVENTS  STATE  ON 

NCP  'ELL  PHL  SET  LOGGING  CONSOLE  SiNh  NODE  AlB  KNOWN  E'.'ENTS 

Appendix  D  describes  the  event  message  format  and  li.sts  the  text  of  all 
DECnet-RSX  event  messages. 

3.3.3   The  Network  Display  Program  (NTD) 

You  can  run  the  Network  Display  Program  (NTD)  on  any  RSX  or  IAS  node  in 
the  network.  NTD  can  produce  two  types  of  real-time  displays: 

•  A  list  of  all  reachable  nodes  in  the  network 

•  A   resource   display   for  a   specified   node   (provided   the   node   supports 
NTDEMO,  the  task  that  collects  the  information  that  is  displayed) 

You  can  display  this  information  on  a  local  VTlOO  or  VT52  terminal  where  it 
is  continuously  updated,  or  you  can  obtain  a  snapshot  printout  of  the  display 
information  on  a  hard-copy  terminal.  Chapter  11  describes  NTD  in  detail. 
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3.4   Testing  Network  Operation 

This  section  discusses  two  types  of  tests: 

•  Loopback  tests  that  exercise  software  and  hardware  components  of  a  DEC- 
net-RSX  node 

•  A  trace  facility,  composed  of  network  management  TRACK  commands  and 
a  trace  interpreter  task  (TRI).  for  diagnosing  software  problems  on  a  F^SI 
hne  between  a  local  DTE  and  the  DCE  to  which  it  is  connected 

3.4.1    Loopback  Tests 

DECnet-RSX  loopback  tests  allow  you  to  exercise  hardware  and  software 
components  to  verify  that  the  node  is  working  properly.  Several  levels  of  tests 
are  provided:  node  level,  circuit  level,  and  line  level  (for  FSI  lines).  Node  level 
tests  verity  the  logical  link  capability  of  a  node.  Circuit  level  tests  verifv  the 
software  controlling  a  circuit.  DECnet-RSX  provides  node  and  circuit  'level 
loopback  tests  to  verify  both  DDCMP  and  Ethernet  hardware  and  software 
You  might  use  these  tests  under  the  following  circumstances: 

•  A  system  has  just  been  installed. 

•  A  system  has  been  modified. 

•  You  want  to  isolate  a  fault. 

•  A  situation  arises  that  causes  you  to  doubt  the  integrity  of  the  system. 

Detai^ls  of  these  tests  are  found  in  the  I)ECnct-RSX  Postinstallation  Check- 
out Irocedures  manual.  Chapter  6  describes  the  following  network  manage- 
ment commands  that  you  can  i.ssue  to  run  the  tests: 

XCP  LOOP  EXECUTOR 
XCP  LOOP  XODE 
XCP  LOOP  LIXE 
XCP  LOOP  CIRCUIT 

3.4.2   The  Trace  Facility 

'^Dc?r  ^"^-I^u^^^^  ^^^^^  ^^""'^'^'^  enables  you  to  diagnose  software  problems  on 
a  PSl  line.  The  facility  traces  message  frames  passing  between  the  X  25  level 

T^  VPD  c^T?-^  ^^^."^Z"''  '^"''''  ^""^  '''^'''  ^^'  ^'^''^  ^'^^"^^«  ^"  «  disk  file, 
i  ne  ALP  bh  1  1  RACE  command  initiates  the  tracing  and  specifies  the  file  to 

contain  the  trace  data.  You  then  use  the  trace  interpreter  task  (TRI)  to 
analyze  and  print  out  the  contents  of  the  trace  file.  Chapter  13  describes  the 
IKl  command  and  its  switches,  and  Chapter  6  describes  the  XCP  SET 
CLEAR,  and  SHOW  TRACE  commands.  ^^  ^i^i, 
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Chapter  4 

Supporting  Remote  RSX-11S  Systems 


This  chapter  describes  procedures  fur  supporting  a  remote  RSX-llS  svstem. 
These  procedures  include 

•  Down-line  loading  an  RSX  US  system  (Section  4.1) 

•  Up-line  dumping  of  RSX-llS  system  memory  (Section  4.2) 

•  Down-line  loading,  checkpointing,  and  overlaying  of  RSX-llS  tasks 
(Section  4.3) 

4.1    Down-llne  Loading  RSX-1 18  Systems 

Down-line  loading  is  a  function  that  allows  a  remote  target  node  to  receive  an 
RSX-llS  operating  system  file  image  from  a  host  (executor)  node  You  can 
issue  an  NCR  LOAD  or  XCP  TRIGGER  command  to  initiate  the  down-line 
load,  or  an  operator  at  the  target  can  request  a  load. 

NOTE 

Server  software  products  that  run  on  Digital  Ethernet  Gommu- 
nicaticm  Server  (DEGS)  hardware,  such  as  the  DEGnet  Router 
Server  and  the  Terminal  Server,  are  described  in  separate 
documentation  (see  the  Preface).  The  .server-specific  documen- 
tation contains  complete  instructicms  for  down-line  loading 
each  server  product  from  a  host  node.  However,  the  procedures 
you  use  to  load  a  server  down  line  from  a  DEGnet-RSX  host 
are  based  on  the  procedures  described  in  this  chapter. 

In  DEGnet-RSX,  the  executor  and  the  host  must  be  the  same  node  when  you 
are  loading  a  system  image  down  line.  In  other  words,  the  executor  node, 
which  actually  performs  the  load  and  is  adjacent  to  the  target,  must  have 
local  access  to  the  load  files.  However,  for  down-line  task  loading,  the  host 
node  for  the  target  can  be  different  from  the  executor  node  that  loaded  it  (see 
Sections  4.1.4.2  and  4.3). 
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The  load  sequence  is  the  same,  whether  you  initiate  the  load  with  N('P  or  an 
operator  requests  the  load  from  the  target.  The  primary  loader  is  the  first 
program  to  run  at  the  target  node.  Typically,  either  this  program  is  executed 
directly  from  the  target  node's  bootstrap  ROM.  or  it  is  included  in  the  micro- 
code of  the  load  device  (DMC.  DMR.  DMF.  DMV.  I'NA.  or  QNA).  Once  the 
target  node's  primary  loader  is  triggered,  the  target  node  sends  a  message  to 
the  executor  node  requesting!  a  program  load.  Usually,  the  primary  loader 
requests  a  secondary  loader  program,  which  in  turn  can  request  a  tertiary 
loader.  The  final  program  to  be  loaded  is  the  operating  system.  In  this  se- 
quence, each  program  requests  the  next  one  until  the  operating  system  is 
loaded. 

At  the  end  of  the  load  sequence,  the  executor  sends  a  message  to  the  target 
that  includes  the  target's  name  and  address  and  the  identification  of  its  ho..t 
node  (see  Section  4.1.4).  If  the  target  system  is  a  Phase  IV  RSX-llS  system, 
the  message  also  includes  the  date  and  time.  The  information  obtained  from 
the  message  is  entered  in  the  target  system's  data  base. 

This  section  provides  basic  information  about  preparing  to  down-line  load  and 
about  using  \CP  commands  to  load  the  system. 

•  Secticm  4.1.1  describes  setting  up  an  RSX-llS  system  image  file  to  be 
loaded  down  line  to  a  target  node. 

•  Section  4.1.2  describes  various  prerequisites  for  down-line  loading. 

•  Section  4.1.3  describes  the  NCP  commands  you  can  use  to  initiate  the 
down- line  load. 

•  Section  4.1.4  describes  the  down-line  loading  data  base  and  the  parameters 
it  contains. 


4.1.1    Sening  Up  an  RSX>11S  System  Image  File 

In  order  to  down-line  load  an  RSX-llS  node,  you  must  create  a  system  image 
file  that  is  either  a  DECnet-llS  node  or  a  stand  alone  RSX-llS  system  (a 
process  control  system,  for  example).  I'o  create  a  DECnet-llS  node,  use  VMR 
and  VXP  to  create  the  system  image  file.  Note  that  if  you  want  to  load 
DPXnet  software  above  the  124KVV  boundary,  you  must  ensure  that  the  sys- 
tem image  file  is  large  enough  to  accommodate  it.  The  system  created  by  the 
following  example  has  its  circuit  set  to  OX: 


>i.'Mry 

Enter  f  i  1  e  ri  a  m  e  : 


^SXllS 


>.'MR 

vnry 

i.'MR 
I.' MR 

i.'mr: 


5ET 
SET 
SET 
INS 
INS 
INS 


/  P00i-  =  2S0 

/MAIN=MCRPAR:2B0:G3:TASK 

/MAIN  =  CE;(PAR:3a3:ai  :COf^ 

BASMCR/Fn;  =  YES 

NE  T AC  P  /  CK  P  =  NO / F I  X  =  YES 

NTINIT/FI!;  =  VES 


>'.'NP  RSKl  IS 

«.'NP--  SET  SV'STEM  ALL 

VNP--  SET  EMECUTOR  STATE  ON 

UNP  SET  LINE  DL'.'-O  ALL 

MNP-^  SET  CIRCUIT  DL','-0  STATE  ON 

MNP>  EXIT 
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Note  that  an  RSX  IIS  system  dees  not  have  to  be  down-line  loaded  Civen 
the  appropriate  hardware,  you  can  also  load  HSX-llS  hv  bootinj;  it  (rom  a 
disk,  a  diskette,  .r  a  magnetic-  tape.  When  booting  from  a  local  load  device. 
U^A  net  must  be  present  in  the  booted  image. 

4.1.2    Set-up  Requirements  for  Down-line  Loading 

Before  attempting  to  down-line  load,  you  must  ensure  that  nodes,  lines,  and 
circuits  meet  the  following  requirements: 

•  The  target  node  must  be  connected  directly  to  the  executor  node.  The 
executor  node  provides  access  to  the  line  and  circuit  levels. 

•  The  primary  loader  must  be  a  cooperating  program  either  in  the  target  or  in 
the  microcode  of  the  target's  device  {DM(\  DMH.  DMP.  DMV.  I'NA.  or 
W-\A).  The  down-line  load  operation  usually  involves  loading  a  series  of 
bootstraps,  each  of  which  requests  the  next  program  until  the  operating 
system  itself  is  loaded. 

•  To  allow  the  tertiary  loader  to  complete  the  load  sequence,  the  RSX  IIS 
system  image  itself  must  be  2K  words  less  than  the  total  memorv  on  the 
target  system. 

•  The  executor  must  have  acce.ss  to  the  load  files.  The  location  of  the  files 
either  can  be  specified  in  the  load  request  or  can  be  a  default  in  the  volatile 
data  base. 

•  The  target  node  must  be  able  to  recognize  the  trigger  me.ssage  or  mu.st  be 
triggered  manually. 

•  The  circuit  involved  in  the  load  operation  must  be  enabled  to  perform 
service  functicms.  It  must  also  be  in  the  OX  or  SKRVKT.  state.  For  exam- 
ple, the  following  command  readies  circuit  I)M(^-()  for  down-line  loadinc^ 
node  BAXCJOR: 

NCP  SET  CIRCUIT  DMC-0  SERV i CE  ENABLE  STATE  ON 

4.1.3    NCP  Down-line  Load  Commands 

I  .se  one  of  the  following  commands  to  initiate  a  down-line  load: 

xcp  LOAD  xodb: 
xcp  load  vla 

XCP  TRIGGER  XODE 
XCP  TRIGGER  VIA 

The  XCP  LOAD  and  TRIGGER  commands  initiate  down-line  loads  differ- 
ently. 

•  I'se  the  LOAD  command  when  the  target's  primarv  bootstrap  ROM  is 
already  running.  The  node  that  issues  a  LOAD  command  is  alwavs  the 
executor  for  the  requested  down-line  load  (.see  Secticm  4.1). 

•  Use  the  TRIGGER  command  when  the  target  is  an  unattended  .system 
equipped  with  an  appropriate  bootstrap  ROM  (see  Section  4.1.2).  The  exec- 
utor for  a  triggered  down-line  load  is  not  nece.ssarilv  the  same  node  that 
issued  the  TRICJGER  command.  This  command  triggers  the  bootstrap 
mechanism  of  a  node  .so  that  it  loads  it.selL 
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RellectiriK  these  dilTerences.  each  command  has  a  different  parameter  list. 
The  LOAD  command's  parameter  hst  includes  all  the  parameters  described 
in  the  next  section.  Any  parameter  you  specify  explicitly  overrides  the  corre- 
sponding entry  (if  any)  in  the  volatile  data  base,  ('onversely.  every  parameter 
you  omit  defaults  to  entries  in  the  volatile  data  base. 

In  contrast,  the  NCP  TRKUIKR  command's  parameter  list  contains  a  subset 
of  the  parameters  described  below  (node  II).  circuit  II).  physical  address,  and 
service  password).  To  use  this  command  or  to  trigger  a  load  manually  from 
the  target,  the  executor's  volatile  data  base  must  contain  appropriate  entries 
for  the  remaining  parameters.  Otherwise  the  executor  does  not  have  sufficient 
data  to  respond  to  the  load  request. 

Note  that  the  LOAD  VIA  and  TRIGGER  VIA  commands  are  versions  of 
LOAD  and  TRIGGER  that  allow  you  to  load  a  target  via  a  specified  circuit. 
The  target's  identification  is  then  obtained  from  the  volatile  data  base.  See 
Chapter  6  for  descriptions  of  these  commands  and  examples  of  their  use. 

4.1.4    Down-line  Load  Parameters 

You  can  define  default  parameters  for  down-line  loading  in  the  permanent 
data  base.  P'ach  target  system  to  be  loaded  has  a  separate  set  of  defaults.  The 
defaults  for  a  specific  target  apply  whether  the  load  is  initiated  by  a  command 
from  the  executor  or  manually  from  the  target.  I'se  the  CFE  DEFINE  NODE 
command  to  set  up  the  permanent  data  base,  which  is  then  loaded  into  the 
volatile  data  base  when  the  system  is  loaded.  To  remove  node  parameters 
from  the  permanent  data  base,  use  the  CFE  PrRCiP!  command. 

The  down-line  load  parameters  that  you  can  define  for  each  target  in  the 
permanent  data  base  include: 

•  A  service  circuit  parameter  for  the  executor  node 
SERVICE  CIRCriT  circuit-id 

•  Parameters  that  pertain  to  the  target  node 

NODE  nnde-id 

NAMF]  node-name 

SERVICE  NODE  VERSION  phase 

SERVICE  DEVICE  decice-txpc 

SERVICE  PASSWORD  password 

HARDWARE  ADDRESS  E-address  (Etherr.et  onlv) 

HOST  node-id 

Note  that  the  NODE.  NAME,  and  HOST  parameters  used  for  the  load  are 
included  in  the  message  that  the  executor  sends  to  the  target  when  the  load 
completes  (see  Section  4.1). 

•  Parameters  that  specify  load  files 

LOAD  FILE  file 
SECONDARY  LOADER  //7c 
TERTIARY  LOADER  file 
DIAGNOSTIC  FILE  //7c  (Ethernet  only) 

All  of  these  parameters  are  described  in  the  following  sections. 
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4.1.4.1    The  Service  Circuit  Parameter  -  The  t..Il..wirm  paranu-ter  spccilies  a 
circuit  that  links  the  executor  node  to  the  adjacent  target  node: 

•  SKHVIO:  ('IH(M  IT  is  the  circuit  over  which  the  load  operation  is  to  occur. 


4.1.4.2   The  Target  Node  Parameters  —  The  to 

target  node: 


lowing  parameters  relate  to  the 


•  XODK  identities  the  target  node  by  name  or  address.  Vou  can  set  up  a 
separate  down-line  load  data  base  entrv  in  the  permanent  data  ha.se  tor 
each  target  node  to  he  down-line  loaded. 

•  X.AMK  associates  a  node  name  with  a  target  node  address  specitied  in  the 
[)revious  parameter. 

•  -I^KHVirK  NODK  VKH.SION  describes  the  target  node  as  either  I'hase  III  or 
I  hase  I\  .  If  you  do  not  detine  this  parameter  either  in  the  data  base  or  in  a 
command,  it  defaults  to  Phase  I\'. 

•  SKHVK^K  DKVICK  specifies  the  controller  nu  the  target  node  end  of  a 
service  circuit.  The  service  device  handles  down-line  loading  in  a  varietv  of 
ways,  depending  on  the  device  used.  The  default  senmdarv  and  tertiarv 
loaders  tor  the  load  operation  depend  on  the  designated  service  device.  This 
parameter  is  therefore  required  for  a  down-line  load  if  secondarv  and  terti- 
ary load  files  are  not  defined  in  the  volatile  data  base.  iSee  the  description 
of  secondary  and  tertiary  load  files  in  .Section  4.1.4.:^  For  example  the 
following  command  identifies  the  service  device  as  a  DMC  device  controller- 


NCP 


?ANGOR  SERVICE  DEVICE  DMC 


NERnICK  P.ASSWORI)  specifies  a  default  service  password,  required  for 
some  devices  to  trigger  the  primary  bootstrap  mechanism  on  the  target 
node.  Depending  on  the  .service  device,  the  password  must  be  a  hexadecimal 
number  in  one  of  two  ranges.  For  DMC.  DMR,  DMP.  „r  DMV  devices  the 
range  is  0  to  FFFF.  For  TNA  or  QX.A  devices,  the  range  is  0  to 
FFFFFFFFFFFFFFFF.  For  example,  the  following  command  sets  the  ser- 
vice password  for  a  node  with  a  load  device  in  the  first  category: 


NCP 


NODE  BANGOR  SERVICE  PASSWORD  FEFE 


'  HARDWARK  ADDRKS.S  specifies  the   Kthernet  hardware  address  origi- 
nally assigned  to  the  DKIWA  or  DEQNA  controller  for  the  target  node 
lb:'-  address  identifies  an  Ethernet  node  before  it  has  started  up  and  set  a 
logicd  address  for  itself,  called  the  physical  address.  (See  Chapter  '^  for  a 
de.cription  of  Ethernet  addressing.)  Vou  can  define  the  hardware  address  in 

'rDirv'V^o  ^'"'■^''"^"^  '^'  ^^^  '-^'^^^'^^'  ^lata  base,  but  not  in  a  LOAD  or 
IHl(x(,hR  command.  The  corresponding  LOAD  or  TRIOOER  command 
parame^er  is  PHYSICAL  ADDRESS. 

If  you  do  not  specify  a  PHYSICAL  ADDRESS  parameter  in  a  down-line 
load  command,  the  HARDWARE  ADDRESS  must  be  defined  in  the  vola- 
tile data  base.Jn  this  ca.se.  DECnet-RSX  attempts  t<.  use  that  HARD- 
WARE ADDRESS  to  communicate  with  the  target  node.  If  the  attempt 
fails.  DECnet-RSX  tries  again  using  an  Ethernet  address  it  has  created 
from  the  target's  node  address. 
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HOST  specifies  the  node  that  will  load  task  files  down  line  to  the  target 
node.  The  host  can  be  the  executor  node  (the  default)  or  any  other  reachable 
node  other  than  the  target  node  itself.  At  the  end  of  the  load  sequence,  the 
target  receives  a  me.ssage  with  the  name  of  the  host  and  {)laces  that  name  in 
its  volatile  data  base.  The  target  can  then  u.se  the  host  node  for  down-line 
task-loading  applications.  In  addition.  RSX  tasks  running  on  the  target  can 
issue  connect  requests  to  SHOST  (see  Section  AM). 


4.1.4.3   Down-line  Load  Files  —  The  following  parameters  specifv  various  load 
files: 


•  LOAD  FILE  specifies  the  file  that  contains  the  RSX-llS  stand  alone  or 
DECnet-llS  system  image  for  loading  down  line  to  the  target  (see  Section 
4.1.1). 

•  SECONDARY  LOADER  and  TERTIARY  LOADER  specify  files  co  aining 
programs  that  are  part  of  the  load  sequence.  If  the  volatile  data  base  con- 
tains secondary  and  tertiary  file  name  entries,  they  are  the  LOAD  or  TRKl- 
OER  command  defaults  for  the  SECONDARY  and  TERTIARY  parame- 
ters. However,  if  the  volatile  data  base  does  not  contain  entries  for  these 
parameters  and  if  you  omit  them  from  a  LOAD  or  TRIGGER  command,  the 
executor  .selects  a  seccmdary  and  a  ternary  file  according  to  the  type  of 
service  device  specified  for  the  target.  The  executor  choo.^es  secondary  and 
tertiary  loader  files  from  the  list  in  Table  4-1.  These  files  are  also  shipped 
with  the  DECnet-US  kit. 

•  DIAGNOSTIC  FILE  (Ethernet  only)  specifies  a  file  containing  diagnostics 
that  the  target  server  system  can  request. 


Table  4-1:    Default  Loader  Files  by  Target  Device  Type 


Device  Type 

Secondary  Loader 

Tertiary  Loadc 

DLV 

SECDLV.SYS 

TERDLV.SYS 

DLll 

SECDL.SYS 

TERDL.SYS 

DMCll 

SECDMC.SYS 

TERDMC.SYS 

DMP 

SECDMP.SYS 

TERDMP.SYS 

DMV 

SEC  DMV.  SYS 

TERDMV.SYS 

DPV 

SECDPV.SYS 

TERDPV.SYS 

Dill 

SECDL.SYS 

TERDU.SYS 

DlTll 

SECDIP.SYS 

TERDIP.SYS 

DlVll 

SECDUV.SYS 

TERDIVSYS 

QNA 

SECQNA.SYS 

TERQNA.SYS 

rx.A 

SECl'NA.SYS 

TERUNA.SYS 
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4.2    Up-llne  Dumping  RSX-11S  Memory 


\ou  can  include  certain  SKT  NODK  parameters  in  the  permanent  data  base 
tha   allow  an  adjacent  HSX-  l  IS  „r  server  node  to  dump  its  memorv  into  a  file 
on  the  local  DK^net   IIM  or  DKC^net    llM  PLl'S  node.  (A  target  node  can 
a  so  dump  Its  mem  )ry  up  lire  to  an  adjacent  DKC^net   VAX  node    See  (he 
DMnrtAAX   System  ManaMrr's  (hndv  (or  details.)  This  procedure  is  re- 
wd  to  as  up-line  dumprng.  Ft  is  a  valuable  tool  (or  crash  analvsis-  that  ,s 
programmers  can  analyze  the  dump  file  and  determine  whv  the  RSX    us 
system  (aded.  When  it  detects  an  impending  svstem  failure,  the  RSX   US 
node  wdl  rec^uest   the  np-line  dump  if  the  appropriate  support   is  selectcMl 
durmg  t^he  RsX-llS  system  Kenerati(m.  The  DECnvt  RSX  Svtimrh  (Irmm- 
tinnand  h.stnllatinn  (iuidv  describes  procedures  (or  geneiating  the  appropn- 
ate  KSa-IIS  support. 


4.2.1    Up-llne  Di;mp  Requirements 

Before  attempting  an  up-line  dump  operation,  vou   must  ensure  .hat   the 
nodes.  Imes.  and  circuits  meet  the  tollowing  requirements: 

•  The  target  node  must  be  directly  connected  to  the  execuf.r  node  bv  a 
physical  line.  I  he  executor  node  provides  the  line  and  circuit  level  access. 

•  The  target  node  must  be  capable  of  requesting  the  up-line  dump  when  it 
detects  a  system  failure.  If  the  dumping  program  (XETPAX)  d(.es  not  exist 
on  the  target,  up-line  dumping  cannot  occur. 

•  The  executor  node  circuit  involved  in  the  dump  operation  must  be  enabled 
and  set  to  OX  to  perform  service  functions.  This  is  the  detau't  state  of  the 
circuit  to  lowing  XETGEX.  For  exan.ple,  the  following  command  readier 
circuit  DMC-O  for  up-line  dumping: 

NCP  SET  CIRCUIT  DMC-O  SERVICE  ENABLE  STATE  ON 

•  If  the  target  does  not  supply  the  Dl'MP  COrXT  value  (see  Section  4  9  2) 
the  executor  must  have  this  value  in  its  volatile  data  base   RSX-llS  svs' 
terns  built  with  the  XETPAX  routine  always  include  the  count! 

•  The  executor  musi  have  a  DUMP  FILE  entry  in  the  volatile  data  base. 
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4.2.2    Up-line  Dump  Data  Base  Parameters 

You  can  define  the  following  up-line  dump  parameters  in  the  permanent  data 
base  using  the  (TK  DEFIXK  NODE  command. 

•  Dl'MP  FILE  file  specifies  the  file  on  the  host  node  that  will  receive  the 
HSX- lis  memory  dump. 

•  Dl'MP  ADDRESS  nddrcss  specifies  the  octal  address  in  the  target's  mem- 
«)ry  at  which  to  begin  the  dump. 

•  Dl'MP  COrXT  number  specifies  a  default  decimal  number  of  memory 
units  to  be  dumped. 


4.2.3    Up-line  Dump  Procedures 

This  .section  describes  the  procedures  for  an  up-line  dump  initiated  bv  a 
target  node.  DE(^net  uses  the  Maintenance  Operation  Protocol  (MOP)  to 
perform  an  up-line  dump  operation.  MOP  is  a  subset  of  the  Digital  Data 
Communications  Mes.sage  Protocol  (DDCMP).  which  .sends  messages  used  for 
circuit  testing,  triggering,  down-line  loading,  and  up-line  dumping.  Refer  to 
the  /;.\V\  Maintenance  Operations  Functional  Specification  for  a  more  com- 
plete discussion. 

There  are  four  steps  involved  in  the  up-line  dump  process.  The  actual  dump 
takes  place  by  repeating  step  ;i  as  described  below: 


1 


3. 


4. 


When  a  target  node  senses  a  .sy.stem  failure,  it  sends  a  memory  dump 
request  to  the  executor  node.  The  request  is  a  MOP  request  dump  .service 
message.  This  message  might  contain  information  about  the  target's 
memory  size  (Dl'MP  (XH'XT)  and  the  up-line  dump  device  tvpe  at'^the 
target. 

If  the  message  from  the  target  includes  a  Dl'MP  (X)rXT  value,  the 
executor  uses  it.  Otherwise,  the  executor  checks  the  target  n  's  entry  in 
its  volatile  data  base  for  the  Dl'MP  COl'XT,  the  target  addre.ss  from 
which  to  start  dumping  (Dl'MP  ADDRESS),  and  the  file  where  the  mem- 
ory will  be  stored  (DUMP  FILE)  for  the  target.  (If  no  entry  exists  for 
DUMP  ADDRESS,  the  value  defaults  to  0.)  The  executor  then  .sends  a 
MOP  request  memory  dump  me.s.sage  to  the  target  with  the  starting  ad- 
dress and  buffer  size  values. 

I  sing  the  values  it  received  from  the  executor,  the  target  returns  the 
requested  block  of  memory  in  a  MOP  memory  dump  data  i  ..sage.  The 
executor  receives  the  block  of  dump  data,  places  it  in  the  Dl'MP  FILE 
increments  the  Dl'MP  ADDRESS  by  the  number  of  location-  .sent,  and 
sends  another  request  memory  dump  message  to  the  target.  This  sequence 
IS  repeated  until  the  amount  of  memorv  dumped  matches  the  Dl'MP 
COUXT  value.  ' 

Once  the  up-line  dump  is  completed,  the  executor  node  automatically 
attempts  to  down-line  load  the  target  system.  It  initiates  the  down-line 
load  hy  sending  a  TRIGCJER  mes.sage  to  the  tar*^et. 
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4.3    Down-ljne  Task  Loading 

Down-line  task  UuuUn^  extends  nonresident  initial  load.  die(k|)..iniin^  and 
over  ay  support  t..  a  DKCnet  IIS  node.  These  functions  are  provided  l.v  the 
sate  hte  h.ader  (SIJ),  on  the  I)K('net  US  node  and  hv  the  the  Host  Ta.k 
Loader  (HL))  on  the  host  DKCnet  node.  The  host  node  in  this  nmtext  ,s 
determined  by  the  HOST  parameter  in  eftect  when  vou  down-lme  load  the 
target  (see  Section  4.1.4.2).  .Neither  HIT)  nor  the  remote  SLI)  has  an  operator 
inter  ace.  Once  the  configuration  is  set  up.  they  operate  transparently  Fi^Mire 
4-1  Illustrates  one  mstance  of  the  down-line  task-loading  capahility. 

Section  4.;il  discu.sses  prerequisites  lor  down-line  task  loading.  Sections  \.:\.-2 
and  4.;lM  discuss  checkpointing  and  overlaying  RSX    US  tasks. 

4.3.1    Prerequisites  for  Down-line  Loading  RSX-11S  Tasks 

Down-line  task  loading  requires  communication  between  the  SLI)  and  HI  I) 

T      -r.     u/n  '"'^  ''  ^'"''^  "^'"''''^  '^'  ^^-^^    ^  •^^  "^^^^^••"'^  generation  proce- 
dure.    I  he  HIT)  task  and  its  mapping  tables  are  built  during  the  network 
generation  procedure  for  a  DKCnet   RSX  host  or  bv  VAX  \MS  for  -i  I)K(" 
net   \  AX  host  (see  Chapter  8). 

The  prerequisites  for  down-line  task  loading  are: 

•  '^LD  must  be  in..talled  and  fixed  into  the  HSX   llS  svstem  image  usin.^ 
\  MK;  for  example. 

E  f.  t  e  r    f  1  1  e  n  a  (II  e  :     R  S ; ;  1  1  S 

VMry  :   INSC.v.v.v  .Gai     SLD/FI;;  =  VES 

yMR>LOA    0'.': 

This  establishes  SLD  as  the  loading  task  (LDR...)  for  the  RSX   1  IS  execu- 
ll'J-  ^^^'^^^  ^^-"^  '"^^^^^  ^'It^^  '^'•P  specified  during  network  generation 
lhe.se  files  are  stored  under  the  network   VW  .,n  the  host  svstem    The 
network  TIC  is  [.v.v.v.64i.  OX":  is  the  overlay  pseudodevice. 

•  Any  tasks  to  be  down-line  loaded  into  or  checkpointed  from  the  RSX  US 
system  must  be  installed,  but  not  fixed,  in  the  RSX  US  .svstem  image 
using  \  MR;  for  example. 

■    '.-'MP 

E  ri  I  e  r     f  1  1  p  )-,  a  /Ti  e  :     fy  s  ■; ;  1  1  2 
VMry     INS     [.v.v.r  .Sa]TLK/TASK  =  TLK 

In  this  example,  typing  RCX  TLK  on  a  terminal  at  the  RSX   IIS  remote 
system  initiates  the  down-line  task  load  of  the  file  f.v.v.v.fi4]TLK.TSK. 

•  If  the  RSX- 1  IS  operating  system  is  not  to  be  down-line  svstem  loaded   vou 
r.Af.l  t  iUK  HOSI  command;  for  example. 

''JNP    RSMllS 
VNPvSET    EKECUTOry    HOST    BOSTON 

In  this  example.  ROSTOX  is  the 
resides. 


name  of  the  host  node  on  which  HLD 


HIT),  the  Host  Task  Loader  task,  must  be  installed  on  the  h 


tern, 


ost  node  svs- 
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Figure  4-1:    Down-line  Task  Loading 


4.3.2    Checkpointing  RSX-11S  Tasks 

Checkpointing  allows  the  interruption  of  an  executing  down-line  loaded  task 
when  a  higher  priority  task  in  the  same  partition  becomes  active.  The  inter- 
rupted task  is  written  from  the  RSX-US  main  memory  to  checkpoint  space 
on  the  host.  Then,  the  higher  priority  task  is  loaded  into  the  partition  and 
activated.  When  the  higher  priority  task  exits,  the  interrupted  task  is  restored 
into  main  memory,  where  it  continues  to  execute. 

Checkpointing  implies  that  a  job  is  already  running  in  the  partition.  (Check- 
point space  must  be  allocated  inside  the  task  image  being  down-line  loaded 
(via  the  ML  .switch  during  RSX-llS  task  build).  Refer  to  the 
RSX'llM/M-PLrs  Task  Builder  Manual  for  details. 


4.3.3    Overlaying  RSX-11S  Tasks 

Disk  overlaying  allows  the  execution  of  segments  of  a  task  to  reduce  the 
memory  or  address  space  needed  to  run  on  an  RSX-llS  system.  HIT)  and 
SLD  automatically  handle  the  reading  of  overlay  segments  by  satellite  sys- 
tems. You  can  specify  this  SLD  capability  during  network  generation  for  the 
RSX-llS  svstem. 
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Chapter  5 

Choosing  Network  Buffer  Parameters 


DECnet-FiSX  software  uses  several  types  of  buffers  to  perform  network  com- 
munications. The  buffers  are  used  to  store  messages  being  sent  and/or 
received  between  DECnet  nodes.  The  permanent  data  base  contains  network 
parameters  that  determine  the  size,  number,  and  memory  allocation  for  these 
buffers.  During  network  generati(m.  either  you  or  the  NETCIEN  procedure 
itself  determines  initial  values  for  these  parameters.  Subsequently,  you  can 
use  CFE  DEFINE  SYSTEM  commands  to  redefine  them  as  necessary.  The 
network  buffer  parameters  include 

•  The  size  and  maximum  number  of  large  buffers 

•  The  maximum  number  of  small  buffers 

•  The  maximum  number  of  control  buffers 

•  The  minimum  number  of  receive  buffers 

This  chapter  describes  these  parameters  and  provides  guidelines  for  defining 
them  so  that  your  node  will  operate  as  efficiently  as  possible. 

5.1    The  NETCFE.CMD  Command  File 

The  NETCFE.CMD  command  file  can  be  used  as  input  to  CFE.  The  file 
contains  a  series  of  CFE  commands  that  defines  the  CETAB.MAC  configura- 
tion as  created  by  NETGEN.  Included  in  the  file  are  commands  that  define 
the  network  parameters  discussed  in  this  chapter.  NETCFE.CMD  can  be 
used  as  a  template  for  making  changes  to  CHITAB.MAC.  In  thir,  case,  revise  a 
copy  of  the  file  and  keep  the  original  NETCFE.CMD  for  reference  Figure  5-1 
an  excerpt  from  a  NETCFE.CMD  file,  shows  CFE  commands  that  define 
network  buffers. 
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5  C  F  E  command  f  i  1  e  »  define  the  S  e  ri  e  r  3  I  e  d  C  E  T  A  B  c  0  ri  f  1  3  m  r  a  t  1  0  ri 

■ 

CETAB 

;  G  e  ri  e  r  a  1  n  e  t  w  0  r  K  c  0  n  f  1  3 1.1  r  a  t  1  0  n 

■ 


DEFINE  SYSTEM  MAXIMUM  CONTROL  BUFFETyS  G 
DEFINE  SYSTEM  MAXIMUM  LARGE  BUFFERS  7 
DEFINE  SYSTEM  MAXIMUM  SMALL  BUFFERS  11 
DEFINE  SYSTEM  MINIMUM  RECEI'.'E  BUFFERS  2 
DEFINE  SYSTEM  LARGE  BUFFER  SIZE  280 
DEFINE  EXECUTOR  SEGMENT  SIZE  2S2 


Figure  5-1:    Excerpt  from  a  Sample  NETCFE.CMD  File 

Chapter  6  describes  the  CFE  DEFINE  SYSTEM  command,  which  you  use  to 
modify  network  parameters  in  the  permanent  data  base. 

5.2   Allocating  Memory  for  Buffer  Space 

Deciding  how  much  memory  to  dedicate  to  buffer  space  always  involves  trade- 
offs between  minimizing  memor\-  usage  and  optimizing  performance.  For 
most  users,  the  values  allocated  by  NETGEN  are  adequate  for  establishing 
reasonable  buffer  resource  requirements  for  support  of  the  node  being  gener- 
ated. The  information  provided  here  is  for  users  who  want  to  further  optimize 
both  memory  utilization  and  DECnet  performance. 

Table  5-1  provides  the  following  information  about  each  buffer  type: 

•  How  the  buffers  are  used 

•  Where  the  buffers  are  located 

•  The  size  of  the  buffers 

•  Factors  that  determine  the  number  of  buffers  required 

All  DECnet  buffers,  with  the  exception  of  control  buffers,  are  located  in  the 
network  buffer  pool.  The  default  buffer  pool  is  named  POOL.,  and  is  created 
as  a  common  partition. 

All  DECnet  processes  must  be  mapped  to  control  buffers.  To  facilitate  this 
mapping,  CCBs  are  allocated  in  executive  address  space. 
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Table  5-1 :    DECr  >t  Buffers 


Use 


Location 


Size 

(in  decimal) 

Factors 
Determining 
Number  of 
Buffers 
Required 


Large  Buffers 

All  receive  messages, 
user  data  transmis- 
sions, logical  link 
connects 


Network  butler  pool, 
common  partition 
POOL.. 

N'ariahle  (user  speci- 
tied.  determines  H^CL 
segment  size) 

Number  of  lines,  de- 
vice types,  number  ot 
logical  links  simulta- 
neously active  and 
performing  data 
transfers,  transmit 
trat'tic 


Small  Buffers 

I'ser  interru|>t  mes- 
sages. VXIj  link  ser- 
vice messages,  node 
(alkrr  messages 

Common  partition 
(POOL. I  in  network 
butler  pool 

:}4  bvies 


Number  of  logical 
link><  simultaneously 
active  and  number  of 
lines 


Control  Buffers 

DDCMP  control  mes- 
sages. DKCnet  inter- 
process communica- 
tion, one  for  each  ac- 
tive .SDH  and  LDH 

Kxecutive  address 
space  (D.SRi 

;W  bvtes 


Number  of  LDBs  and 
.SDBs 


5.3    Large  Buffers 


DECnet-RSX  software  uses  large  buffers  (LDBs)  for  intermediate  storage  of 
all  user  data  being  sent  (transmit  buffers),  for  storage  of  all  incoming  mes- 
sages (receive  buffers),  and  on  routing  nodes,  for  storage  of  all  route-through 
packets.  During  NETGEX,  the  user  specifies  the  size  of  LDBs.  NETGEN 
itself  calculates  the  number  of  LDBs  to  be  allocated  based  on  this  and  other 
NETGEN  specifications. 


• 


5.3.1    Determining  LDB  Size 

This  section  discusses  factors  in  determining  the  optimum  LDB  size  for  your 
node.  The  LL.>  >ize  that  you  define  at  NETCiEN  determines  the  node's  seg- 
ment size,  which  is  the  size  into  which  large  user  messages  are  divided  for  end- 
to-end  transmission.  NETGEN  calculates  the  segment  size  to  be  ldbsizc-\H. 
After  NETGEN,  use  CFE  or  NCP  to  change  segment  size  (DEFINE  or  SET 
EXECUTOR  SEGMENT  BUFFER  SIZE). 

If  the  segment  sizes  of  communicating  nodes  —  the  nodes  at  either  end  of  a 
logical  link  —  differ,  both  nodes  use  the  smaller  of  the  two  sizes.  For  commu- 
nication to  be  successful,  the  chosen  segment  size  must  not  be  t(^o  large  to  be 
handled  by  intermediate  nodes  —  that  is.  nodes  that  fall  in  the  iDuting  paths 
between  source  and  destination.  The  LDB  size  for  a  routing  node  equals  the 
maximum  size  of  route-through  packets  that  the  node  can  handle.  If  all  nodes 
within  a  network  have  the  same  LDB  size,  route-through  packets  too  large  to 
handle  will  not  cause  end-to-end  communications  to  fail. 
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In  some  cases  it  may  be  necessary  to  reduce  the  local  node's  segment  size  to 
ensure  that  transmitted  packets  can  successfully  ♦raverse  the  network.  Like- 
wise, it  may  be  necessary  to  increase  the  local  LDB  size  to  ensure  that  your 
node  can  handle  route-through  packets. 

Additi(mal  factors  you  must  consider  in  defining  LDB  size  include 

•  The  record-blocking  factors  used  by  your  application  programs 

•  The  amount  of  memory  that  you  wish  to  allocate  to  LDHs 

•  The  error  rate  of  the  communication  lines 

•  Your  throughput  requirements 

For  example,  if  your  applications  are  blocking  data  into  2r)(vbyte  records  and 
the  LDB  size  is  256,  DECnet  software  must  split  each  record  into  two  seg- 
ments in  oruer  to  transmit  it.  With  an  IH-byte  KCL  header  affixed  to  each 
segment,  one  segment  would  have  2;^8  bytes  of  data  and  an  18  byte  header, 
and  the  other  segment  would  have  18  bytes  of  data  and  an  IS-bytt*  header.  In 
this  type  of  situation,  you  would  be  incurring  ^he  overhead  of  segmenting 
records  without  using  the  segments  efficiently,  and  at  the  same  time  you 
would  be  using  up  more  memory  than  necessary  for  buffer  space. 

1  he  obvious  solution  would  be  to  increase  the  LDB  size  defined  for  ihe  end 
nodes  and  thereby  establish  a  larger  segment  size  that  could  accommodate 
the  256-byte  records  without  splitting  them.  However,  this  action  would  add 
to  the  amount  of  memory  allocated  to  LDBs  —  .something  that  you  might 
wish  to  avoid.  A'so,  as  the  size  of  the  segments  increases,  the  effective 
throughpu*^  rate  (data  r'^feived  without  error  versus  data  received  with  errors) 
will  decrease.  Thus,  to  resolve  the  situatif>n  in  a  manner  that  would  best  suit 
your  requirements,  you  might  establish  a  I^DB  si,  ?  (plus  the  R(Ti  header  size 
of  18  bytes)  that  is  an  even  multiple  of  the  record  size  used  by  your  applica- 
tion programs.  In  this  way  you  would  minimize  the  amount  of  memory  allo- 
cated to  LDBs  and  increase  the  throughput. 

5.3.2    Number  of  LDBs  to  Allocate 

Major  factors  that  determine  the  number  of  LDBs  you  should  allocate  include 

•  The  number  and  type  of  local  devices  and  controllers 

•  The  amount  oi  route-through  traffic  anticipated  if  yours  is  a  routing  node 

•  The  number  of  logical  links  likely  to  be  active  simultaneously 

The  last  row  in  Table  o-l  summarizes  these  factors,  which  you  can  use  to  help 
determine  how  many  LDBs  you  need  to  maintain  a  reasonable  level  of  per- 
formance. For  most  nodes,  some  trial  and  error  is  generally  required  to  arrive 
at  an  optimum  number. 
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Note  that  N'KT(iEN  itself  calculates  the  minimum  number  of  LDHs  to  he 
reserved  for  use  as  receive  buffers  (called  the  minimum  receive  tl:  shold). 
When  the  number  of  available  LDBs  is  equal  to  or  less  than  the  threshold, 
only  requests  for  receive  buffers  will  be  serviced.  In  this  way,  receive  traffic 
gets  priority  over  transmit  traffic  (Requests  for  transmit  buffers  will  be 
queued  until  the  number  of  available  LDHs  is  above  the  threshold.)  The 
receive  buffer  hreshold  should  be  set  no  higher  than  the  sum  of  the  buffers 
required  for  all  lines  on  the  svstem.  To  redefine  the  minimum  receive  thresh- 
old, use  the  (TK  DEFINE  SYSTEM  MINIMIM  RE(T:IVE  BrFFERS  com- 
mand. 

Table  5-2  gives  the  recommended  number  of  LDHs  for  each  communications 
device  supported  by  DF^Cnet   RSX. 

Table  5-2:    LDBs  Required  by  Different  Devi':e  Types 


Device  Type 

Number  of  LDBs 
Used  by  Device 

DL.DLV 

1 

DV 

1  per  line 

I)Z.I)Z\ 

1  per  line 

KDZ 

1  per  line 

KDl^ 

1  per  line 

Drp.nr.Div 

1 

PC  I. 

1 

I)M("  (low  speed. 

up   t(i 

19 

.2K  hi 

ts'seeond) 

o 

HMC  ihiyh  speed. 

r)(iK 

t(l 

IM  I 

..V  second) 

4 

IN  A 

6 

(^N.-\ 

6 

• 


Routing  nodes  require  more  buffers  than  nonrouting  nodes  to  provide  space 
for  route-through  traffic.  If  there  are  insufficient  LDHs.  route-through  packets 
will  be  discarded,  resulting  in  degraded  end-to-end  pertormance.  1  he  tollow- 
ing  algoritlim  can  be  used  to  calculate  the  number  of  buffers  required  for  a 
particular  configuration  to  support  route-through  traffic,  it  assumes  that 
route-through  traffic  contributes  less  than  HO  percent  of  the  total  bandwidth 
of  all  lines  and  will  give  a  low  probability  of  packets  being  discarded. 

mimhvr-(if -buffers      5xSQRT(n) 

where  n  is  the  number  of  lines. 

Nonrouting  nodes  no  nof  requirM  bufiers  io  su|.)t)or(  the  route-throuidh  capa- 


• 


device  (see  Table  o  2).  In  this  case,  the  receive  buffer  Ihreshoici  shouki  c  set 
to  the  value  required  for  the  device  (as  indicated  in  Table  5  2)  or  2.  whichever 
is  lower. 
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5.4    Small  Buffers 


DECnet-RSX  software  uses  small  buffers  (SDBs)  to  send  user  interrupt  mes- 
sages. End  Communications  layer  (ECL)  link  service  messages,  and  some 
control  messages.  SDBs  have  a  fixed  length  and  are  used  in  place  of  LDBs  in 
order  to  optimize  resource  utilization.  NETGEN  calculates  the  number  of 
SDBs  to  be  allocated. 

At  least  one  SDB  is  required  for  each  of  the  logical  links  that  are  in  use 
simultaneously.  An  additional  SDB  should  be  allocated  for  each  physical  link. 

NETGEN  calculates  a  default  number.  Then,  when  the  system  is  in  opera- 
tion, you  can  use  the  Network  Display  Program  (NTD),  described  in  Chapter 
11.  to  monitor  the  number  actually  in  use.  If  necessary,  you  can  adjust  the 
buffer  allocations  using  CFE. 


5.5    Control  Buffers 


Each  active  LDB  and  SDB,  while  it  is  allocated,  needs  to  have  a  control  buffer 
(CCB)  associated  with  it.  DECnet-RSX  software  also  uses  CC  Bs  to  pass 
parameters  between  processes  and  to  send  DDCMP  control  messages.  CCBs 
are  fixed  length.  NETGEN  calculates  the  minimum  number  of  CCBs  to  be 
allocated.  If  more  are  needed,  they  are  allocated  dynamically. 

One  CCB  is  required  for  each  active  LDB  and  SDB.  One  CCB  is  generally 
required  for  each  logical  link.  An  additional  CCB  should  also  be  allocated  for 
each  of  the  lines  that  will  simultaneously  be  in  the  STARTING  state  (that  is, 
set  to  the  ON  state). 

NETGEN  calculates  this  value.  Use  NTD  to  monitor  the  number  of  active 
logical  links  and  to  detect  allocation  failures.  You  have  reached  the  optimum 
number  when  an  allocation  failure  occurs  only  occasionally. 
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Chapter  6 

Network  Management  Utilities  (CFE,  NCP,  VNP) 


Ihis  chapter  describes  the  nefvork  management  utilities  and  summari/es 
their  commands.  ('FE  commands  modify  the  permanent  data  base  while 
NCP  commands  modify  the  volatile  (running)  data  base.  VXP  commands  are 
used  to  modify  the  system  image  file.  Each  utility  is  described  below,  includ- 
mg  how  to  invoke  it  and  how  to  exit  it.  Details  on  how  to  use  the  commands 
and  individual  command  descriptions  follow. 

6.1    Configuration  File  Editor  (CFE) 

The  Configuration  File  Editor  (CFE)  is  a  privileged  utilitv  program  that 
accepts  commands  from  a  terminal  or  from  an  indirect  command  file  to  mod- 
ify or  display  parameters  in  the  configuration  file,  CETAB.MAC.  which  is 
produced  during  network  generation.  CFE  commands  operate  exclusively  on 
the  permanent  data  base.  Note  that  all  CFE  commands  are  privileged".  To 
invoke  CFE.  you  must  be  privileged  to  acce.ss  the  CETAB.MAC  file. 

6.1.1    Invoking  CFE 

^L^^^TJ^y"^'"^     ^^^'     ''''''     """'^     ^'''''''     ^^"^     ^^''''^    ^^"^^     ^'^^^     ^»"^P'-    which 

C  hi  AB.MAC  resides.  After  network  generation,  CETAB.MAC  reside^  under 
one  of  the  following  I'ICs: 

DECnet-RSX-llM/M-PLCS  [.v,54] 

DECnet-RSX-llS  [.v.64] 

where  .v  is  the  network  TIC  selected  during  network  generation. 
A  privileged  user  can  access  CFE  by  using  the  RCX  command: 

MCR   -RUN     CrE 

CFE  prompts 


E  )-i  t  P  r     file 


I'l  a  (Tt  e 


Enter  the  name  of  the  configuration  file  you  want  to  modifv.  If  vou  omit  any 
part  of  the  file  specification,  the  default  is  SY:[rj/m'n/-u;riCETAB  .MAC 
CFE  then  prompts 


CFE 


Enter  your  CFE  command  after  the  prompt  and  press  HETCHX 
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6.:. 2    Exiting  CFE 

There  are  three  ways  to  exit  CFK: 

1.  Use  the  EXIT  command  or  Ctrlz;  in  response  to  the  CFE  prompt  tr  termi- 
nate an  editing  session  and  update  the  configuration  file. 

CFE    F.;;iT 

MCR 

2.  Use  the  EXIT  PURGE  command  in  response  to  the  CFE  prompt  to  termi- 
nate an  editing  session,  update  the  configuration  file,  and  delete  the  old 
file. 

CFE    EXIT    Pur.GE 
MCry 

3.  Use  the  KILL  command  in  response  to  the  CFE  prompt  to  abort  an 
editing  session.  The  configuration  file  is  not  updated,  and  the  old  file  is 
retained. 

CFE     KILL 

Mcrv  ■ 


6.2    Network  Control  Program  (NCP) 

The  Network  Control  Program  (NCP)  is  a  utility  program  that  accepts  com- 
mands from  a  terminal  or  from  an  indirect  command  file  to  load,  control, 
monitor,  and  test  the  network  software,  as  well  as  to  down-line  load  an 
RSX-1  IS  system. 

There  are  two  versions  of  NCP:  a  full  set  of  commands  for  DFXnet-  llM  and 
M-PLUS  systoms  and  a  subset  of  these  for  DECnet  US.  Both  sets  of  com- 
mands are  described  in  detail  in  this  chapter  and  are  summarized  in  Appen- 
dix A. 

You  can  execute  most  NCP  commands  both  locally  and  remotely  (see  Section 
6.2.3).  Appendix  A  lists  all  NCP  commands  supported  by  DECnet -RSX  and 
flags  those  that  are  not  executable  remotely.  It  also  highlights  those  com- 
mands that  are  specific  to  DECnet  RSX  only. 

6.2.1    Invoicing  NCP 

There  are  three  ways  to  invoke  NCP: 

L      MCR     NCP 

NCP  then  prompts 

NCP 

Enter  your  NCP  command  after  the  prompt  and  press  RETURN. 

2.  MCR    NCP  mm m and 

where  command  is  any  valid  N(T^  command.  With  this  method,  you 
return  to  MCR  after  the  command  is  executed. 

3.  t^CR    HCP  f^rommnnd  filf  : /ir^l 

where  command  file  is  the  name  of  an  indirect  command  file  containing 
NCP  commands  and  AFR  is  an  optitmal  switch  that  allows  you  to  trace  the 
commands  as  they  execute.  You  can  nest  command  files. 
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6.2.2    Exiting  NOP 

Use  either  the  EXIT  comn-iand  or  ^trlz^  in  response  to  the  \('P  prompt  to  exit 
\CP. 


6.2.3    Executing  NCP  Remotely 

Most  \CP  commands  can  be  issued  at  your  terminal  for  remote  execution. 
This  feature  is  useful  in  many  ways;  for  example,  you  can  use  it  to  modify 
parameters  or  display  information  at  a  remote  node,  or  you  can  down-line 
loa  I  a  node  that  is  not  adjacent  to  your  system.  Remote  execution  can  be 
accomplished  in  two  wp  -.. 

•  To  execute  a  sinjjle  \CP  command  at  a  remote  node,  i.^sue  it  with  the  TKI.L 
prefix  (see  the  TKLL  command  description  in  this  cha[)teri.  Appendix  A 
summarizes  all  \CV  commands  and  flags  the  lew  that  cannot  be  executed 
with  the  TP^LL  prefix. 

•  To  execute  a  .series  of  \CV  commands  at  a  remote  node.  u>v  the  SKT 
FlXECl  TOR  NODp]  command  to  temporarily  set  a  specified  remote  node 
as  the  executor.  Any  subsequent  commands  that  you  issue  are  executed  at 
that  node  until  you  return  execution  to  your  own  node  by  issuing  a  CI.KAR 
HXECITOR  NODP:  command.  (Both  commands  are  described  in  this 
chapter.)  If  you  exit  IsCP,  control  automatically  .reverts  to  the  local  node. 

When  you  issue  command^  to  be  executed  at  a  remote  node,  you  may  have  to 
specify  access  controi  info -n^pt ion  to  access  the  node,  ^'ou  can  append  the 
access  control  information  .o  the  node  name,  or  you  can  specify  an  alias  n(.(ie 
name  that  includes  access  ..-ontrol  information,  ('hapter  2  provides  more  infor- 
mation on  access  control  and  the  use  of  aliases. 

The  remote  node  interprets  all  commands  according  to  its  own  network  man- 
agement software  and  uses  any  required  default  parameters  from  its  own  data 
ba.se.  Therefore,  you  must  issue  the  command  as  if  it  were  originating  at  the 
remote  node.  Consult  the  appropriate  DKCnet  documentation  if  the  node  i^ 
other  than  DErnet-RSX. 

6.3    Virtual  Netvjork  Processor  (VNP) 

The  Virtual  Network  Processor  (VNP)  is  a  privileged  utility  program.  It  ac- 
cepts commands  from  a  terminal  or  from  an  indirect  command  file  to  modifv 
or  display  the  DEC^net-RSX  software  configuration  as  contained  on  an 
RSX-llM  or  RSX-llS  system  image  tde.  You  cannot  use  VNP  on  a  DEC- 
net-RSX-llM-PLl'S  disk  image.  All  VNP  commands  are  privileged  and 
operate  exclusively  on  the  system  image  file.  VNP  does  not  support  com- 
mands that  cause  displays  to  be  written  to  a  file. 

Before  using  \'NP.  you  must  use  the  virtual  monitor  routine  (\'MR)  to  set  the 
NEll  IC  in  the  RSX  .system  image  tile.  I'se  (^ne  ot  the  following  commands: 


VMR  .SET   NETriC    :v.v.v.o4] 
VMR  >SET /NETl'K^    ;.v.v.v.641 


(RSX  ll.M) 

(RSX  US) 


\  NP  uses  the  NETl'ir  when  it  searches  for  the  network  .software  on  the  LB: 
device.  Therefore,  it  is  imperative  that  the  pn.per  NETl'IC  be  set  in  the 
system  image  file  and  that  LB;  be  assigned. 
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romiiiaiuis  issued  to  \'NI'  recjuirt'  that  you  havt-  previously  run  \'MI<  on  the 
tar,Tet  system's  ima^e.  For  exaniph'.  il  you  iuleiui  to  use  the  network  on 
HSX  lis.  vou  must  set  the  executor  state  to  ON  with  V\l\  \('P  on 
HSX  lis  does  not  support  this  command.  See  Chapter  \  U,v  an  example  of 
this  use  ot  VMH  and  VNP. 

6.3.1    Invoking  VNP 

A  privileged  user  can  access  \'\P  by  usin^  the  KIN  command; 


MCry   ••• 


VNI'  prompts 


E  !i  t  e  r     f  1  1  e  i.  a 'II e 


Knter  the  name  o!  the  operatm^'  >v«>U'ni  tile  vou  want  to  modil\.  It  you  d<i  not 
specifv  the  de\ice  and  \']('.  the  S^':  desicc  and  the  current  I'lC  are  used. 
(There  i>  no  delault  tile  name.)  \'NP  then  prompts 


'NP 


Knter  your  \'NP  command  alter  the  prompt  and  pre>>  I^F/I'IKN. 

6.3.2    Exiting  VNP 

r>e  either  the  FAIT  command  or  ^Kl  in  re.^pon>e  to  the  \'NP  prompt  to  exit 
VNF. 

6.4    Using  the  Network  Management  Utility  Commands 

The  toHowin^  >ections  contain  general  information  on  command  usa^e. 

6.4.1    General  Command  Format 

Mo>t  command>  consist  ot  three  parts:  the  command  verb,  a  component  on 
which  the  command  operates,  and  one  or  more  parameters  that  turther  (pial- 
its  the  action  to  be  taken  on  the  component.  Examples  ot  the  general  com- 
mand format  lollow; 


Command  Verbs       Components 

Cl.K.AK  KXKCtrOH 


Parameter  Lists 


<■  •  r   T  ••  »  1 1 


i    !    TV!.'    (. 


t    M.  "V «  >  W    V     !    ! 


V 


HOST! 

KKCKIVK  P 

.X.sSWOHI): 

.••rHANSMIT 

I'.ASSWOHI) 

1 

-.    ! 

r 

! 

S  >    1 
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For  each  command,  you  must  supply  the  verb,  one  comjxment  option,  and 
(usually!  one  or  more  of  the  parameters,  (ienerally.  the  order  in  which  you 
specify  parameters  does  not  matter.  However,  some  commands  have  parjime- 
ters  that  are  mutually  exclusive  for  the  comj)onent.  For  example,  in  the 
(M.KAR  LINK  command  above,  you  must  select  either  ALL  or  (M)r\'rKH 
TIMKH  (as  indicated  by  the  braces),  whereas  you  can  select  one  or  more  of 
the  parameters  tor  (M.KAH  KXKdTOK  (as  indicated  by  the  brackets).  On 
many  oi  the  SHOW  and  LIST  commands,  you  do  not  have  lo  specify  anv 
parameters  because  there  is  a  deiault. 


6.4.2    Issuing  Commands 

Knter  the  command  keywords  separated  by  spaces. 

Continuing  a  command.  To  continue  a  lon^  command  to  the  next  line,  insert 
a  hyphen  (-)  where  you  wish  to  break  the  line:  then  enter  ret.  Wm  lan 
continue  the  command  following  the  prompt  on  the  next  line. 

Example: 

CFE  .LrlNE  LINE  DZ-l-Z  DUFLE;;  FULL  SPEED  9GU'»  -  MT 

CFE  ■VECTOR'  36r.    CSTv  IGOiZn  Wf 

CFE 


•Any  necessarv  spaces  in  the  command  must  be  entered  eveji  it  One  occurs  just 
belore  the  hyphen. 

Abbreviating  command  keywords.  When  entering  a  command,  vou  can 
abbreviate  any  keyword  to  the  first  three  or  more  unicjue  characters.  For 
example,  the  following  two  versions  of  the  same  command  aree(jually  valid: 


NCP    •  .-.  - 

NCP  S'-'.  "^L 


ACCESS  ALL  DESTINATIONS  CHARACTERISE 

'HA 


Note  that  X2."i-.A('('KSS  is  abbreviated  to  the  first  five  unicjue  character^  to 
differentiate  it  from  other  entities  beginning  with  the  Xl'A-  character  string. 
For  clarity  and  consistency,  all  examples  in  thi.«^  manual  show  the  full  com- 
mand syntax. 

Entering  comment  lines.  >'ou  can  enter  comment  lines  b\  prefacing  each 
hne  nt  text  with  a  senucolon  (:). 


6.4.3    Using  the  Help  Facility 

I'se  the  HKLP  command  whenever  vou  need  assistance  in  selecting  network 
management  commands  and  parameter  options.  Kxecution  of  this  command 
bv  anv  of  the  three  utilities  causes  a  summarv  of  help  text  to  be  di^plaved. 

Example: 

NCP    -■■ 
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I'se  the  HELP  keyword  with  a  selected  command  (and  component )  to  display 
the  portion  of  the  help  file  relevant  to  that  command. 

Example: 


■HCP 
NCP    HELP    LINE 


6.4.4   Command  Prompting 

Command  promptinjj  provides  additional  assistance  when  using  network 
management  commands.  At  any  point  where  you  can  type  a  space,  type  Mtj 
instead.  This  produces  a  prompt  requesting  the  required  information.  If  you 
need  additional  information  after  a  prompt,  you  can  type  |sc  again  to  display 
a  shorter  form  of  the  help  message. 

Example: 

NCP    --"     -r 

S  e  I     c  0  m  p  0  i"i  e  ri  I  :     • 


6.4.5    Exit  Status  and  Error  Handling 

When  (TF!.  \CF.  or  \'NP  terminates,  it  sets  a  bit  that  can  be  inspected  using 
the  normal  RSX  exit  status  handling  techniques  described  in 
RSX-llM/M-PLrS  operating  system  documentation.  The  utility  .sets  the 
exit  status  to  indicate  the  worst  case  tor  the  commands  executed.  The  possible 
statuses  and  their  meanings  are  summarized  below. 


Numeric 

Status 

Value 

Success 

1 

Warning 

0 

Krror 

2 

.Severe  Krrcir 

4 

Meaning 

The  command  executed  as  requested. 

Mmor  error.  F'rocessing  continues. 

The  command  was  accepted,  but  tailed  to  execute  completely. 
The  system  waits  tor  a  new  command. 

The  command  was  not  accepted    Processini:  stops  and  control 
returns  to  the  monitor. 

If  the  command  executes  successfully,  you  receive  the  utility  prompt  on  the 
next  line,  whereupon  you  can  issue  another  command.  If  the  command  is 
unsuccessful,  you  receive  an  error  message  on  the  next  line  indicating  the 
reason  for  the  error,  followed  by  the  utility  prompt. 
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Example: 


MCR-NCP 

NCP:SET  LINE  DMC-n  TOP 

NCPLOAD  NOOF  "VZ 

N  C  P    -    Load    f  a  1  1  e  d  »     1  x  ri  e    c  o  (luti  m  n  i  c  a  I  i  o  )-i    error 
NCP 


Error  messages  for  all  three  utilities  are  provided  in  Chapter  14. 

NOTE 
The  following  NCP  commands  do  not  affect  the  exit  status: 

CLEAR  EXECITOR  NODE 

EXIT(or@Rrz) 
HELP 

SP:T  EXECITOR  NODE 


6.5   Command  Descriptions 


The  rest  of  this  chapter  is  devoted  to  descriptions  of  the  individual  commands 
and  their  parameters.  If  you  need  more  information  on  the  command  compo- 
nents or  their  parameters,  refer  to  the  tutorial  chapters  for  a  more  in-depth 
discussion. 

Ctmimands  are  presented  in  alphabetical  order.  The  command  name  and  the 
utility  (or  utilities)  to  which  it  applies  are  printed  at  the  top  of  the  page 
(many  NCP  and  \'NP  commands  have  the  same  format  and  are  described 
together).  The  full  DECnet-RSX-llM/M-PLCS  set  is  described  first.  The 
RSX-llS  subset  is  de.scribed  at  the  end  of  the  chapter  (NCP/S  appears  at  the 
top  of  those  pages).  All  commands  are  designated  as  privileged  (P)  or  nonpri- 
vileged  (NP)  at  the  top  of  the  page  next  to  the  command  name.  On  combined 
NCP/VNP  commands,  an  NP  designator  applies  to  NCP  commands  only,  as 
all  V'NP  commands  are  privileged. 

6.5.1    Graphic  Conventions 

Review  the  graphic  conventions  outlined  at  the  front  ol'  this  manual,  espe- 
cially the  usage  of  braces  |  }  and  brackets  [  1.  The.se  c()nventi(ms  are  used 
throughout  the  command  descriptions  to  specify  parameter  selection  and  op- 
tionality.  Shaded  text  indicates  commands  or  parameters  that  are  valid  for 
PSI  users  only. 
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6.5.2    Standard  Definitions 

The  following  parameters  and  user-supplied  variables  are  l're(|uently  used  in 
the  command  descriptions.  They  are  described  here  to  avoid  needless  repeti- 
tion. Exceptions  to  these  definitions  are  lalled  out  in  individual  parameter 
descriptions. 


acc-con-info 


circuit-ia 
csr-addrcss 

dest-namr 

dtv-addros 
E- ad  dress 

K-nodv-namc 
flic 


iiroup-namr 

line-id 

millisv(i-nds 
nodr-address 
node- id 


tvidr-name 


Access  control  information  in  one  ot  the  following 
lorms: 

/user-id\Jpassu()rd\J  account]] 

ISKH  user-id  ;PASS\V()HI)  pa.s-,s/rorcy  [ACCOrXT 

account]] 

NOTE:  DKCnet   RSX  does  not  use  the  account  field. 

For  more  information  on  access  control,  see  Chapter 
2. 

.A  DKCnet  circuit  in  the  form  dei-c\-u][.t].  For  more 
intormation  on  circuit  identitication.  see  Chapter  1. 

CSH  address  in  the  range  ot  l()(l.(M)()  to  177.77(i  loc- 
tali. 

1  to  ()  alphanumeric  characters. 

1-  to  ].")-digit  hexadecimal  integer  address. 

A  string  ot  12  hexadecimal  digits  in  the  form  nn-nn- 
nn-nn-nn-nn. 

See  description  for  node-name,  below. 

A  file  specification,  which  is  interpreted  according  to 
the  executor  node's  file  system.  The  standard  tormat 
for  RSX  is  dci:[uic:fil<'name.t\pe:Ler. 

1  to  (i  alphanumeric  characters. 

A  line  in  the  torm  dev-c[-u].  For  more  intormation  on 
line  identification,  see  Chapter  2. 

A  decimal  integer  in  the  range  ot  1  to  ().'),.").' I"). 

A  decimal  integer  in  the  range  of  1  to  102:^ 

A  node  name  (see  nnde-name)  or  node  address  (see 
node-address\.  For  more  intormation  on  node  identi- 
fication, see  Chapter  2, 

1  to  fi  al{)iianumeric  charai'ters.  including  at  leaM  I 
alphabetic  character. 
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passuurd 


ranav 


sriands 
CHAHArTKHISTK  S 


rorxTKHs 


STATIS 
Sl'MMAHV 
SCOPE  scopr 


TO  filr 


A  hexadecimal  nunil)er.  For  DDCMP  circuits,  it  is 
in  the  ran^e  otO  to  FFFF;  lor  Kthernet  cinuits.  it  is 
in  the  ran^e  ofO  to  FFFFFFFFFFFFFFFF  (up  to  Hi 
hexadecimal  dibits). 

One  or  two  1-  to  4-di^it  integers  in  'he  ran^'e  of  <>  to 
9999.  It  you  specify  two  sul)addresses.  they  mu>t  he 
separated  by  a  hyphen  <-).  and  the  second  nujst  he 
greater  than  the  first  (e.^..  10- KM)).  See  I'Si  .\rt- 
II  (irk-spfcifir  Infnrmatmn  for  the  maximum  len^^h 
of  a  sul)address  on  your  network. 

A  deci  iial  integer  in  the  raii^ie  of  1  to  fi'i.Aii'). 

Displays  static  i.. formation  for  the  specified  compo- 
nent. This  type  of  information  is  automatically  dis- 
played for  all  CFK  LIST  commanris. 

(Invalid  for  \'\P)  Displays  error  and  i)erformance 
statistics  for  the  specified  com|)onent.  See  Appendix 
F  for  a  summary  of  network  counters. 

(Invalid  for  \'NPi  Displays  dynamic  information  for 
the  specified  comi)onent. 

(Default)  Displays  only  the  most  useful  information 
tor  the  specified  component. 

(Valid  for  privilei^ed  users  only)  (Qualifies  the  extent 
to  which  the  specified  operation  applies  (default:  re- 
questor's terminal  I.  Possible  values  for  scopi'  are: 


(iLOBAL 

TKRMINAL 

trrm-id 


The  operation  applies  to  all  termi- 
nals. 

The  operation  applies  to  the  >^peci- 
fied  terminal  onl\ .  where  trrm-id  i> 
a  standard  HSX  ternnnal  device 
identification. 


(Valid  for  NCP  only)  Directs  output  to  the  specified 
file  or  device  at  the  local  node  (default:  information 
displayed  at  the  calling  terminal).  If  you  specify  an 
existing  file  as  output,  tit'  information  is  appended 
to  that  file.  Information  is  transferred  in  ASCII  in 
the  same  formai  as  it  is  dis{)layed  Mt  the  terminal. 
(See  the  description  oi  file,  above,  for  format.) 
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6.5.3    RSX>11M/M-PLUS  CFE,  NCP,  and  VNP  Command 
Summary 

This  section  destrihes  all  ot  the  CFK  and  SCP  coninianris  supported  l)y 
RSX  IIM/M  PIA'S.  VNF  commands  supported  hv  HSX  llM  are  descrihed 
in  tandem  with  the  corresponding  NCP  command.  HSX  1  IS  NCP  commands 
are  descrihed  in  Section  ().'). 4. 
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NCP/VNP 


NP 


CLEAR  ALIAS 


Tse  the  NTP  CLEAR  ALIAS  lommand  to  remove  the  specitied  alias  node 
nameis)  from  the  volatile  data  base.  Lse  the  \'\P  conimand  t(>  do  the  ^anie 
with  the  system  imatre  tile. 


Format: 


ri.VAH  Tali,  aliasks      1 

<  ALIAS  nlias-nam,      > 


scorn    sr.//)r 


KNOWN  ALIASKS 


where 


ALL 
ALIASKS 

ALIAS 


SCOPE 

scapr 


iX'alid  tor  privileged  users  onlyi  Removes  all  alia>  name>. 


Removes  oiilv  the  specified  alias  name. 


KNOWN         Removes  all  alias  names  tor  the  specitied  scope 
ALIASES 


(Invalid  tor  ALL  ALI.ASKSi  See  definition  in  Section  ri.ri.2. 


Example: 


NCP 


This  command  removes  the  association  of  alias  N^T^  with  terminal  TT'2:. 
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NCP 
CLEAR  CIRCUIT 


Use  the  CLEAR  CIRCUIT  command  to  zero  the  specified  PSI  circuit  counter 
timer(s)  in  the  volatile  data  base. 

Format: 

CLEAR  /circuit  circuit-id  \  COUNTER  TIMER 
I^KNOWN  CIRCUITSJ 

where 

CIRCUIT        Zeroes  the  counter  timer  for  the  specified  circuit  only. 
circuit -id 

KNOWN         Zeroes  the  counter  timers  for  all  known  circuits. 
CIRCUITS 


Example: 


NCP  :^EAR  CIRCUIT  PVCl  COUNTER  TIMER 


This  command  zeroes  the  counter  timer  for  PSI  circuit  PV'Cl 
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NCP/VNP 


CLEAR  EXECUTOR 


I'se  the  \CV  ("LP^AR  KXKCl'TOK  command  to  remove  specified  executor 
node  parameters  Irom  the  volatile  data  base.  I'se  the  \'NP  command  to  do  the 
same  with  the  system  imajie  file. 

Format: 

(LKAH  FAKCHTOH       HOST] 

HKCKIVK  PASSWORD 


where 


TRANSMIT  PASSWORD; 


HOST 

RKfEIVE 
l\ASS\VORn 

TRANSMIT 
PASSWORD 


Removes  identification  of  the  host  tor  the  executor  node.  The 
executor  then  defaults  to  itself  as  host  tor  service  o|)erations. 

Removes  the  e>  -cutor  node's  receive  password. 


Removes  the  executor  node's  transmit  password. 


Example: 


NCP  CLEAR  EKECUTOry  RECEIVE  PASSWORD 


This  command  removes  the  receive  password, 
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NCP 

CLEAR  EXECUTOR 
NODE 


NP 


Use  the  CLEAR  EXECUTOR  NODE  command  to  return  XCP  command 
execution  to  the  local  node  after  issuing  an  XCP  SET  EXECITOR  NODE 
command. 

Restriction: 

You  cannot  use  the  TELL  prefix  with  this  command. 

Format: 

CLP:AR  EXECITOR  NODE 

Exampie: 

NCP    SET    EXECUTOR    NODE    BOS 


NCPCLEAR    EN'ECUTOR    NODE 

The  first  command  causes  subsequent  NCP  commands  to  be  executed  at  node 
BOS.  The  second  command  returns  NCP  command  execution  to  the  local 
node. 
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NCP/VNP 


CLEAR  LINE 


Use  the  \CP  CLEAR  LINE  command  to  unload  the  specified  line(s)  and  to 
remove  all  associated  parameters  from  the  volatile  data  base.  Tse  the  VNP 
command  to  do  the  same  with  the  system  image  file.  You  can  also  use  the 
NCP  command  to  zero  the  counter  timer(s)  for  the  .specified  PSI  line(s). 

Restriction: 

Before  you  unload  a  DECnet  line,  all  circuits  a.ssociated  with  the  line  must  he 
in  the  OFF  state  (see  SET  CIRCriT).  Anv  VSl  line  to  be  unloaded  must  als„ 
be  in  the  OFF  state  (see  SET  LLNE  and  SET  KNOWN  LINES). 

Format: 

CLEAR  /link  linr-id         \     /aLL 

KNOWN  LINES  f     i  COUNTER  TIMER 


where 


} 


LINE 

line- id 


Clears  the  specified  line  onh 


KNOWN         Clears  all  known  lines. 
LINES 


ALL 


Unloads  the  specified  line(s)  and  removes  all  associated  line 
parameters. 


COINTER     (Invalid  for  VNP)  Zeroes  the  counter  timer(s)  for  the  'specified 
TIMER  PSI  line(s). 

Examples: 

NCP    CLEAR    LINE    DMC-'-^    ALL 

This  command  unloads  DECnet   line  I)MC-()  and  removes  all  parameters 
a.ssociated  with  it.  thus  making  DMC  ()  unusable. 


NCP 


INE  SDP-1  COUNTEfy  TIMER 


This  command  zeroes  the  counter  timer  for  I\SI  line  SDP  1. 
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NCP/VNP 


CLEAR  LOGGING 


I  se  the  \rp  CLKAH  LOddlXd  lonnnaiKi  to  rciiiovf  !*>^t,'iii^r  paranu'ters 
from  the  volatile  data  base.  Tse  the  V.NP  (oniniand  to  do  the  same  with  the 
system  ima^'e  file. 

Restriction: 

Whenever  a  i-ireuit.  line,  module,  node,  or  sink  is  specified  in  ;  f'LK.AH 
V!^i^'?^^'  lommand.  an  event  list  or  an  ALL  FAKNl'S  or  KNOWN 
KN'FATS  parameter  must  also  he  imluded. 


CLKAH 


Format: 

""known  LOtidINC     "^ 

I  i.()(;(;iN(;  ("on.solk 

]  LOC.CINd  FII.K 

y.()(;(;iN(;  monitor 


NA.MK; 

AIJ.  KVKNTS 
FA-K.N'I'S  list 
KNOWN  KVKNTS 


r 


nHCiVV  rinuitid 
J   LINK  Imvid 

<  MODULE    fX25-PR0T0C0Cl 
^X25-SERVER      V 
lX29-SERVER     J 
L  NODK  nndr-i({ 

SINK  rKXKcrroR 

NODK  fnndr-id\ 

VSHosrj 


where 


KNOWN  Removes  parameters  tor  all  known  lotrLMni:  (omnoiu-nts 

L()(;(;iN(; 

LOOOINC;       Removes  parameters  (or  lo^^ing  to  the  console 
OONSOLK 

L()(i(iIN(i       Removes  parameters  tor  logKin^'  to  a  tile 
KILK 

LO(;(;iN(;       Removes  parameters  for  logginK  to  a  monitor  program 
MONITOR 


NA.MK 

ALL 
K\KNTS 


Returns  the  lo^'^ri„^r  component  to  its  default  (console:  ('00: ; 
file:  LH:'LfVKVKN'rLO(;.SVS;  monit-r:  MON...). 

Removes  parameters  for  all  lo^j^jing  event  classes  and  types. 


KXKNTS         Removes  parameters  for  the  lo^^in^  event  class  and  type(s) 
''■^^  specified  in  list.  See  Chapter  2  for  the  event  list  format. 


KNOWN 
KVKNTS 


Removes  parameters  for  all  lo^trinK  events  that  DKCnet   RSX 
can  ^'enerate. 


(1H(M  IT         (Invalid  for  VNP)  Inhibits  event  lo^^nng  for  the  specified  circuit 
circiut-id  (see  restriction). 
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LINK 

linr-id 

Monri.K 


NODK 
nodc-id 

SINK 


Examples: 


Inhibits  event  lo^z^in^  tor  the  specified  line  (see  restriction!. 


(Invahd  tor  VNPi  Inhibits  event  lojigin^  tor  the  ^pecitied  mod- 
ule (see  restriction). 

Inhibits  event  lo^^'in^:  lor  the  specified  node  (see  restrictioni. 


Inhibits  lo^^in^'  ot  the  specitied  event  i>i  at  the  >pecilied  no(ie 
(see  restrictioni. 

KXKCI,  TOI^  (I)etaiihi  K\ents  are  not  to  be  lo^^'ed  at  the 

execiit(tr  node 

NODK  nndr-id        K\ents  are  not  to  be  lotr^'ed  at  the  <[)e(  ified 

node. 

NODKsHOST        .Invahd    tor    NCPi    Kvent>   are   n<.t    to    be 

loy^'ed  at  the  host  node. 


NCP 


This  command  ceases  lou^ini:  of  e\ent  J.l  to  the  console. 


NCP 

NCP 


NC  P 


The  first  command  causes  2.1  eveni.s  to  be  lo^'^ed  on  the  (onsole  on  node  PHL. 
The  second  command  enables  lo^inin^  ot  2.1  event:-  to  TTl:  on  the  local  node. 
The  third  comiiiand  reverts  event  lo^Kinti  to  the  l(»cal  node  onlv.  and  2.1 
events  are  no  longer  logKt'd  to  the  console  on  node  PHL. 
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NCP 

CLEAR  MODULE 
X25-ACCESS 


I'se  the  CLF.AF^  MODl'LF!  X^")  ACCESS  command  to  remove  destination 
names  from  the  volatile  data  base. 

Format: 

CLEAR  MODULE  X25-ACCESS  TaLL  DESTINAHONS        ")   ((SCOPE)  scopd 

/  DESTINATION  dest-name  > 
1  KNOWN  destinations! 

where 


ALL 
DKSTINATIONS 

DKSTINATION 

drst-namr 

KNOWN 
DKSTLNATIONS 


Removes  all  destination  names,  regardless  ot  scope 


Removes  only  the  specified  destination  name. 


Removes  al'  destination  names  for  the  specified  scope 


SCOFF  scnpr  See  definition  in  Section  ^.'^.2. 

Examples: 


NCP    Z^E^^^    r^OOULE       :?-aCCE5S    -• 


'N5 


This  command  removes  all  destination  names. 


NCP 


t        Zf-ACCESS  DESTINATION  CUGlll  ^ERMIN- 


This  command  removes  destination  name  CrCilll  associated  with  terminal 
TT2:. 


• 
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NCP 


CLEAR  MODULE 
X25-PROTOCOL 


Use  the  CLEAR  MODULE  X25-PROTOCOL  command  to  zero  the  counter 
timer{s)  for  the  specified  DTE(s)  or  to  remove  from  the  volatile  data  base  all 
parameters  for  the  specified  DTE(s)  or  ^roupis). 

Format: 

CLEAR  MODULE  X25-PROTOCOL  QdTE  dte-addre8s\       /aLL  V 

\KNO  WN  DTES  /        \COUNTER  TIMER  J 

(group  group-nameX    ALL 
)KNOWN  GROUPS  J 

Clears  the  specified  DTF]  only. 

Clears  all  known  DTEs. 

Removes  parameters  for  the  specified  f^roup  only. 

Removes  parameters  for  all  known  groups. 

Removes   all    parameters   for   the   specified    l)TE(s)    or 
group!  s). 

Zeroes  the  counter  timer(s)  for  the  specified  DTE(s). 


where 

DTE  dte-address 
KNOWN  DTES 

GROUP 

firoup-name 

KNOWN 
GROUPS 

ALL 


COUNTER 
TLMER 

Examples: 


NCP:>CLEAR  MODULE  ;'25  -  PPOTOCOL  DTE  123456^83  COUNTErv  TJMEP 

This  command  zeroes  the  counter  timer  for  local  DTP]  123456789. 

NCP    Clear    module     -'25- PfvPTOCOL     Kr..juJN    r-.^-,  .r       .-^^^ 

This  command  removes  parameters  for  all  known  groups. 
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NCP 

CLEAR  MODULE 
X25-SERVER 

CLEAR  MODULE 
X29-SERVER 


Ise  the  CLEAR  MODl'LE  X2.VX29-SERVER  commands  to  zero  the  counter 
timer  or  to  remove  the  specified  destination  name(s)  and  all  associated 
parameters  from  the  volatile  data  base. 


Format: 


CLEAR  MODULE  /X26-SERVEr\ 

\X2a-SERVER/ 


COUNTER  TIMER 


where 

COrXTER 
TIMER 

DESTIXATIOX 

dest-name 

KNOVVX 
DESTINATIONS 

Example: 


/destination  dest-name\ 

\known  destinations^ 


Zeroes  the  server  module  counter  timer. 


Removes  parameters  for  the  specified  destination  only 


Removes  parameters  for  all  known  destinations. 


NCP>ClEAR  module  "Z5-SErvi.'ErT  DESTINATION  CHIZ^f  alL 


This  command  removes  all  parameters  for  destination  rHI2()n 
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^ 


NCP/VNP 


CLEAR  NODE 


Use  the  XCP  CLEAR  XODF:  command  to  remove  the  specified  node  parame- 
ter from  the  volatile  data  base.  I'se  the  VNP  command  to  do  the  same  with 
the  system  image  file. 


Format: 

CLKAR  NODK  nndr-id 


where 

NODE  node-id 

CIRCriT 
NAME 

Example: 


friRcrn^ 

l^NAMF     J 


Specifies  the  node  whose  parameters  are  to  he  removed. 
You  must  use  a  node  name  if  you  are  removing;  the  circuit 
identification. 

Removes  the  circuit  identification  associated  with  the  node 
name  for  node  level  loopbacl:  testing. 

Removes  the  node  name  associated  with  the  node  identifi- 
cation. 


NCP>CLEAR  NODE  TESTETv  CIRCUIT 

7'his  command  removes  the  circuit  identification  a.ssociated  with  node  name 
TESTER. 
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NCPA^NP 


CLEAR  OBJECT 


Use  the  NCP  CLEAR  OBJECT  command  to  remove  all  object  parameters 
from  the  volatile  data  base.  Use  the  VNP  command  to  do  the  same  with  the 
system  image  file. 

Format: 

CLEAR  /object  txpv-codv    \  ALL 
I^KNOVVN  OBJECTS  J 

where 


OBJECT 

type-code 

KNOWN 
OBJECTS 

ALL 


Removes  parameters  for  the  specified  object  only.  Use  an  object 
type  code  from  Appendix  B. 

Removes  parameters  for  all  known  objects. 


(Required  for  NCP:  optio'  il  for  VNP)  vSpecifies  that  all  param- 
eters are  to  be  removed. 


Example: 


NCP 


JE 


.:  -I  T     ALL 


This  command  removes  all  parameters  for  object  245. 
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NCP/VNP 


CLEAR  PROCESS 


I  se  the  NCP  CLEAR  PROCESS  command  to  unload  a  process  and  remove 
all  process  parameters  from  the  volatile  data  base.  I'se  the  VNF  command  to 
do  the  same  with  the  system  image  file. 

Restrictions: 

•  You  can  unload  a  process  only  when  it  is  not  being  used. 

•  n  you  clear  \\V  from  the  volatile  data  base  and  then  reload  it  using  SCV 
SET  PROCESS,  you  must  also  issue  the  SET  MODl'LE  \2r^  PROTOCOL 
command  (first  with  STATE  OFF  and  then  with  STATE  ()\)  to  update  the 
process  pointers  to  the  data  base. 

Format: 

TLEAH  PROCESS  pmcrss-namr 
where 

PROCF^SS  Specifies  the  process  to  unload.  I'se  a  process  name  from  the 

process-name      table  in  Chapter  2. 

Example: 


NCP 


3CES> 


This  command  unloads  the  I)LX  process  and  removes  all  parameters  associ 
ated  with  it. 
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NCP/VNP 


CLEAR  SYSTEM 


I'se  the  NCI^  CLKAH  SVSTFAI  mmniand  to  unload  the  Comniunieations 
Kxeeutive.  release  any  resources  hein^  used  hy  the  network,  and  remove  all 
system  parameters  from  the  volatile  data  base.  Ise  the  \NP  command  to 
unload  the  Communications  pAecutive  in  the  system  ima^e  tile. 

Restrictions: 

•  Nou  cannot  u>e  llie   I'KI.L  pretix  with  thi>  command. 

•  Hetore  vou  i»ue  MM'  Cl.KAK  SV.s'I'KM.  the  executor  mu>t  he  in  the  OKK 
Male  (>ee  \('l»  SKI"  KAKCl'IOK). 

•  It  you  are  running  I'Sl.  the  X.J.".  server  module  Fnu>t   he  \n  the  OFF  Mate 
(see  SKI"  MODILK  X_':.  SKK\  KR». 


Format: 

(■[.FAR  SNS  IFM 
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• 


NCP 
CLEAR  TRACt 


Ise  the  ('LKAH  THAO:  command  to  stop  tracing  of  PSI  frames  on  the 
spentied  line(s).  For  more  information  on  the  trace  interpreter  task,  see  Chap- 


ter 1.3 
Formal: 

CLKAH  I 

where 


"HACK   fuNK  l,nr-id       \ 
\activk  IJNKS J 


LINK  linr-id      Disahles  tracing  on  the  specified  line  only. 

ACTIX  K  Disables  tracing  on  i',11  active  lines 

LINKS 

Example: 

NCP    CLEAfy     TfyACE    LINE    SDP-u 

This  command  disahles  tracing  of  F.SI  frames  on  liae  SDP  0. 
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CFE 
DEFINE  CIRCUIT 


Use  the  DEF'INE  CIRCUIT  command  to  modify  circuit  parameters  in  the 
permanent  data  base.  You  can  also  use  this  command  to  create  parameters  lor 
PVCs. 

Restriction: 

The  values  used  for  MAXIMUM  DATA  and  MAXIMUM  WINDOW  must  be 
the  same  as  the  packet  size  and  window  size  agreed  upon  by  the  network 
authorities  lor  the  PVC. 


Format: 

DEFINE 


'.  /circuit  circuit-id    \ 
"l^KNOWN  CIRCUirsJ 


where 

CIRCUIT 

circuit -id 

KNOWN 
CIRCUITS 

CHANNEL 

channel-number 

COST  cost 


[CHANNEL  channel-number] 

[COST  cost] 

(COUNTER  TIMER  seconds] 

(DTE  dte-address] 

[HELLO  TIMER  seconds] 

[MAXIMUM  BROADCAST  ROUTERS  number] 

(MAXIMUM  DATA  byte-count] 

(MAXIMUM  RECALLS  retry-count] 

(MAXIMUM  WINDOW  block-count] 

[MULTIPOINT  ACTIVE  actue-ratu,] 

(NUMBER  dte-address] 

(RECALL  TIMER  seconds] 

[ROUTER  PRIORITY  prion tx] 


SERVICE    rDISABLEVl 

\e\able  /J 

"STATE  /0FF\1 

V>N  jj 
TRIBITARY  tnh-address] 

usage  /incoming vi 
\outgoing/J 


Modifies  (or  creates)  parameters  for  the  specified  circuit 
only. 

Modifies  (or  creates)  parameters  for  all  known  circuits. 


Specifies  the  logical  channel  number  lor  a  PSI  PVC 
(range:  0  to  4095). 

Specifies  the  routing  cost  of  the  circuit  (range:  1  to  25). 
Messages  will  travel  between  nodes  along  the  path  with 
the  smallest  total  cost. 
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COUNTER 
TIMER  .seconds 

DTE 

clte-addrvss 

HELLO  TIMER 

seconds 

MAXIMUM 

BROADCAST 

ROUTERS 

number 

MAXIMUM 
DATA  bxte-count 


MAXIMUM 
RECALLS 

retry-count 

MAXIMUM 
WINDOW 

block-count 


MULTIPOINT 
ACTIVE 

active-ratio 

NUMBER 

dte-address 


Sets   a  timer  whose  expiration   causes  a   PSI  circuit 
counter  logging  ev  .-nt. 

Specifies  a  local  DTE  for  a  PSI  PVC. 


Specifies  the  frequency  of  routing  hello  messages 
sent  to  an  adjacent  node  on  the  circuit. 

Specifies  the  maximum  number  of  routing  nodes  that  an 
Ethernet  circuit  can  maintain  (range:  0  to  .T2;  default: 
10). 


Specifies  the  maximum  packet  size  for  a  PSI  PVC.  For 
DLM  SVCs,  this  parameter  specifies  the  maximum 
packet  size  to  be  negotiated  with  the  network,  if  allowed. 
This  parameter  value  (range:  16  to  1024)  must  be  at  least 
5  bytes  less  than  the  maximum  data  size  specified  for 
PSI  lines  (see  DEFINE  LINE).  By  default,  packet  size 
takes  the  network  value  specified  by  the  MAXIMUM 
DATA  parameter  in  the  DEFINE  MODULE  X25-PRO- 
TOCOL  command.  See  MS'/  Netuork-specific  Informa- 
tion for  the  network  value  of  this  parameter. 

Specifies  the  maximum  number  of  times  that  DECnet 
should  attempt  to  place  a  call  to  establish  an  SVC 
(range:  0  to  255;  default:  5). 

Specifies  the  maximum  number  of  blocks  allowed  to  be 
outstanding  on  the  circuit  for  PSI  PVCs.  For  DLM 
SVCs.  this  specifies  the  maximum  number  of  outstand- 
ing blocks  to  be  negotiated  with  the  network,  if  allowed 
(range:  1  to  7).  By  default,  window  size  takes  the  net- 
work value  specified  by  the  MAXIMUM  WINDOW  pa- 
rameter in  the  DEFINE  MODULE  X25-PROTOCOL 
command.  See  RSX-IJ  f\SI  Network-specific  Informa- 
tion for  the  network  value  of  this  parameter. 

(Valid  only  for  circuits  with  multipoint  software)  Speci- 
fies the  rate  at  which  a  tributary  in  the  active  multipoint 
state  is  polled  (range:  1  to  255). 

(Valid  for  outgoing  SVCs  only)  Specifies  a  remote  DTE 
address  used  by  DECnet  when  trving  to  establish  an 
SVC. 


RECALL  TIMER      Sets  the  interval  to  wait  after  a  failed  call  before  at- 
seconds  tempting  to  place  another  call  to  establish  an  SVC  (de- 

fault: 30). 
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ROUTER 
PRIORITY 

priority 

SERVICE 


STATE 


TRIBUTARY 

trib-address 

USAGE 


Examples: 


Specifies  the  priority  that  the  executor  node  on  this  cir- 
cuit is  to  have  in  selecting  a  designated  router  for  the 
circuit  (range:  0  to  255). 

Specifies  whether  the  circuit  is  enabled  or  disabled  for 
down-line  loading  and  loopback  testing. 

Sets  the  circuit's  operational  state  to  OFF  or  ON.  For 
circuits  owned  by  the  executor,  the  state  of  the  corre- 
sponding line(s)  must  be  ON. 

Specifies  the  data  link  physical  tributary  address  of  the 
multipoint  circuit  (range:  1  to  255). 

Specifies  the  availability  of  a  DLM  SVC  for  either  in- 
coming or  outgoing  switched  calls. 


CFE    DEFINE     _:r/CUIT    DZ-3    STATE    OFF 

This  command  makes  circuit  DZ-3  unavailable  for  use. 

CFE  DEFINE  KNOWN  CirvCUITS  MAKIMUM  TvECALLS  10 

This  command  sets  to  10  the  maximum  number  of  times  DECnet  should 
attempt  to  place  a  call  on  all  known  circuits. 


9 
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DEFINE  EXECUTOR 


Use  the  DEFINE  EXECUTOR  command  to  modify  executor  node  parameters 
in  the  permanent  data  base. 


Format: 

DEFINE  EXECUTOR 


[ADDRESS  nnde-addrrss] 

[BROADCAST  ROUTING  TIMER  spconds] 

[HOST  nodt'-address] 

[IDENTIFICATION  id-strinf^] 

[MAXIMUM  ADDRESS  nodv-address] 

[MAXIMUM  BROADCAST  NONROUTERS  numhi^] 

[MAXIMUM  CO^^T  number] 

[MAXIMUM  HOPS  number] 

[MAXIMUM  LINKS  number] 

[MAXIMUM  NODE  COUNTERS  number] 

[NAME  node-name] 

[ROITING  TIMER  seconds] 

(SEGMENT  BUFFER  SIZE  number] 

SUBADDRESSES  range] 

"VERIFICATION 


S"  [STATE]   /OFfY] 


where 

ADDRESS 

node-address 

BROADCAST 
ROUTING  TIMER 

seconds 

HOST 

node-address 

IDENTIFICATION 

id-string 


MAXIMUM 
ADDRESS 

node-address 

MAXIMUM 

BROADCAST 

NONROUTERS 

number 


Specifies  the  address  of  the  executor  node. 

Sets  a  timer  whose  expiration  forces  a  routing  update  on 
Elthernet  circuits,  which  produces  a  routing  configura- 
tion message  for  each  adjacent  node. 

Specifies  the  host  node  address  for  down-line  load,  trig- 
ger, and  up-line  dump  operations. 

Specifies  the  text  identificaticm  .string  for  the  executor 
node  (range:  1  to  :]2  characters).  You  mu.st  use  quota- 
tion marks  ('*)  to  delimit  any  string  containing  blanks 
or  tabs.  To  indicate  a  quotation  mark  within  a  quoted 
string,  use  a  double  quotation  mark  (to  distinguish  it 
from  a  string  delimiter). 

Specifies  the  maximum  node  address  of  the  executor 
or  any  remote  node  known  to  the  executor. 

Specifies  the  maximum  number  of  nonrouting  nodes 
that  the  executor  node  can  have  on  its  Ethernet  circuits 
(range:  0  to  65535:  default:  f)4). 
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MAXIMUM  COST 

number 

MAXIMUM 
HOPS  number 

MAXIMUM 
LINKS  number 

MAXIMUM  NODE 
COUNTERS 

number 


NAME 

node-name 

ROUTING 
TIMER  seconds 

se(;ment 
buffer  size 

number 


SUBADDRESSES 

ranf^e 

VERIFICATION 
STATE 


Specifies  the  maximum  total  path  cost  allowed  to  any 
node  (range:  1  to  1022). 

Specifies  the  maximum  number  of  routing  hops  allowed 
from  the  executor  node  to  anv  other  node  (range;  1  to 
30). 

Specifies  the  maximum  number  of  active  logical  links 
for  the  executor  node  (range:  1  to  255). 

Specifies  the  maximum  number  of  node  counters  al- 
lowed. If  you  require  more  counters,  the  existing  ones 
are  reassigned  (m  demand  in  the  same  order  as  they 
were  originally  assigned.  U'se  a  decimal  integer  greater 
than  1,  but  not  exceeding  the  executor  maximum  ad- 
dress (range:  1  to  170). 

Specifies  the  node  name  of  the  executor. 


Sets  a  timer  whose  expiration  forces  a  routing  update  on 
non-Ethernet  circuits. 

Specifies  the  maximum  size  of  transmit  buffers  (in 
bytes),  thereby  controlling  the  size  of  the  NSP  message 
segment  to  be  sent.  This  value  is  the  maximum  size 
message  that  the  End  Communications  layer  can 
transmit:  it  does  not  include  routing  or  data  link  over- 
head (range:  1  to  4096;  default:  18  bytes  less  than  the 
large  buffer  size  specified  in  the  DEFINE  SYSTEM 
command).  The  segment  buffer  size  can  never  be 
greater  than  the  large  buffer  size  minus  18  bytes. 

Specifies  a  range  of  local  DTE  subaddresses  that  are 
valid  on  any  PSI  circuit  for  incoming  calls  to  the  execu- 
tor node. 

Sets  the  logical  link  access  control  verification  state  for 
the  executor  node. 

OFF  The  executor  node  does  not  verify  acce.ss  control 
on  any  incoming  requests. 

ON  The  executor  node  verifies  access  control  on  all 
incoming  connect  requests  according  to  the  op- 
tions set  for  each  object  (see  the  discussion  of 
access  control  in  Chapter  2). 
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Examples: 

CFE 


This  command  sets  the  executor  address  to  21 


CFE 


Phis  command  sets  the  maximum  number  of  active  lo^ncal  links  to  20. 
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CFE 

DEFINE  LINE 


I'se  the  DKFIXK  LINK  lommand  to  modify  line  paranu'ters  in  the  perma- 
nent data  base. 

Format: 

DKhJNK    flASK  litu-ui        \       ('DNTKOLLKK   VS\{  vsr-nddnss, 
\k\()\\\  links/    rcONTKOLLKH  /L()()|>HA(K\1 

L  \N()KMAI,     )\ 


where 

LINK  linr-id 
KNOWN  LINKS 

rONTROLLKR 
(\SR  vsr -address 

CONTHOLLKH 


("OLNTKH 
TIMKI^  svcnnds 

nrpLKx 


(COUNTER  TIMER  seconds] 

rnrpLKx  rKrLL\1 

L  \halk;J 

(HOLDBACK  TIMER  milliseconds] 
(MAXIMUM  DATA  byte-count] 
(MAXIMUM  RETRANSMITS  retn-count] 
(MAXIMUM  WINDOW  block-count] 

MLLTIPOINT  \)V:\\)  drad-ratio, 
I'KIOHITY  h(irdu(in-imnnt\\ 
(RETRANSMIT  TIMER  milliseconds] 

SPKKI)  haud-ratt'. 
SIATK    fCLKARKD' 
OFK 
ON 
LNIT  (\SH  i>r-<iddn'..^, 
\K("r()K  ii'itor-addrr^s, 


Modifies  parameters  tor  the  specified  line  only. 

Indicates  that  parameter^  tor  all  known  lines  are  to  he 
moditied 

Specifies  the  address  of  the  first  CSR  for  the  line  control- 
ler. 

(For  Kthernet.  DMC  DMR.  DMR.  and  DMV  lines)  Spec- 
ifies tht  controller  mode  tor  the  line. 

LOORHACK      Internal  device  loophack  mode. 

NORMAL  Normal  o^eratin^  mode. 

Sets  a  timer  whose  e.vpiration  causes  a  LSI  line  counter 
lo^'^in^'  event. 

(Not  applicable  for  f*SI  or  P'thernet  lines)  .Sets  the  hard- 
ware transmission  mode  to  full  duplex  or  halt  duplex. 
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HOLDBACK 
TIMER 

milliseconds 

MAXIMUM 
DATA 

h\te- count 


MAXIMUM 
RETRANSMITS 

retry-count 

MAXIMUM 
WINDOW 

block-count 

MULTIPOINT 
DEAD 

dead -ratio 

PRIORITY 

hardware-priority 

RETRANSMIT 
TIMER 

milliseconds 


Specifies  the  length  of  time  that  a  PSI  message  acknowl- 
edgment can  be  held  back  in  order  to  be  included  with 
another  data  message. 

Specifies  the  maximum  frame  size  (in  bytes)  for  the 
line{s).  This  value  must  be  at  least  5  bytes  larger  than  the 
maximum  data  size  specified  for  PSI  circuits  (see  the 
DEFINE  MODULE  X25-PROTOCOL  command) 
(range:  16  to  1024). 

Specifies  the  maximum  number  of  retransmissions  of  a 
frame  over  the  specified  PSI  line(s)  (range:  0  to  255). 

Specifies  the  mcximum  number  of  frames  for  which  out- 
standing PSI  acknowledgment  messages  are  allowed 
(range:  1  to  7). 

(Valid  only  for  lines  with  multipoint  software)  Specifies 
the  polling  rate  for  a  tributary  in  the  dead  multipoint 
state  (range:  1  to  255). 

Specifies  the  hardware  prioritv  of  the  controller  (range-  4 
to  7). 

Specifies  the  time  to  elapse  before  a  block  is  retransmit- 
ted (range:  100  to  10,000).  CFE  rounds  off  all  values 
within  this  range  to  the  nearest  hundred  milliseconds. 


SPEED  baud-rate    Sets  the  line  baud  rate  to  one  of  the  following: 


50 

300 

2400 

75 

600 

3600 

110 

1200 

4800 

134 

1800 

7200 

150 

2000 

9600 

STATE 


To  set  a  high  speed  device  (that  is,  over  9600  baud),  enter 
>9600  or  the  actual  baud  rate. 

Sets   the   line's   operational   state   when   the  system   is 
loaded. 


CLEARED 


OFF 


ON 


The  line  is  not  loaded.  A  DDCMP  control- 
ler line  may  not  be  set  to  CLEARED  if  any 
circuits  on  it  are  in  the  ON  state. 

The  line  is  loaded,  but  not  available  for 
use.  A  DDCMP  controller  line  may  not  be 
set  to  OFF  if  any  circuits  on  it  are  in  the 
ON  state. 

The  line  is  loaded  and  available  for  normal 
use  except  during  temporary  (Acrrides  for 
service  operations.  All  PSI  lines  are  set  to 
ON.  If  the  line  is  a  DDCMP  point-to-point 
line  or  a  DDCMP  tributary,  the  corre- 
sponding circuit  is  also  set  to  ON. 
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UNIT  CSR 

csr-address 


Specifies  the  address  of  the  first  CSR  for  a  DECnet  de- 
vice controlled  hy  a  KMC-U. 

NOTE 

With  the  KDP.  a  unit  CSR  can  he  speci- 
fied for  any  unit  on  the  controller. 

With  the  KDZ,  a  unit  CSR  can  be  speci- 
fied only  for  the  first  unit  set  in  the  associ- 
ated DZ  multiplex  group. 


VECTOR 

vector-address 


Examples: 


Specifies  the  vector  address  of  the  line  controller.  You 
must  use  the  vector  address  selected  on  the  device  or  0  if 
the  address  is  unknown  (range:  I)  to  774  octal). 


CFE     OEi^lNE    ''NOWN    LINES    MA"ir«"j*^    DA'^A    25G 

This  command  establishes  the  maximum  frame  size  for  all  known  lines  as  256 
bvtes. 


CFE     DEf^INE    LINE    DZ-3    SPEED     2G' 


This  command  sets  the  baud  rate  of  line  DZ-3  at  36(X). 
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CFE 


DEFINE  LOGGING 


Use  the  DEFINE  LOGGING  command  to  create  or  modify  logging  parame- 
ters in  the  permanent  data  base. 


Format: 

DEFINE 


KNOWN  LOGGIN(;  ^ 
LOGGING  CONSOLE  I 
LOGGING  FILE  ^ 

LOGGING  MONITOR 


■/EVENTS  list  Y] 

\knovvn  events/J 


STATE 


where 

KNOWN 
LOGGING 

LOGGING 

console 

LOGGING 
FILE 

LOGGING 
MONITOR 

EVENTS  list 


KNOWN 
EVENTS 

STATE 


Example: 


Indicates  that  the  specified  parameters  are  to  be  created  or 
modified  for  all  known  logging  components. 

Indicates  that  the  specified  parameters  are  to  be  created  or 
modified  for  the  logging  console  only. 

Indicates  that  the  specified  parameters  are  to  be  created  or 
modified  for  the  logging  file  only. 

Indicates  that  the  specified  parameters  are  to  be  created  or 
modified  for  the  logging  monitor  program  only. 

Specifies  the  event  cla.ss  and  type(s)  to  be  logged.  See  Chapter 
2  for  the  event  list  format. 

Specifies  that  all  events  that  DECnet-RSX  can  generate  are  to 
be  logged. 

Sets  the  operational  state  of  the  logging  component  when  the 
system  is  loaded.  When  the  state  is  OFF,  events  are  discarded. 


CFE>DEFINE    LOGGING    flOIMITOR'     STATE    ON 


This  command  changes  the  state  of  the  logging  monitor  to  ON. 
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CFE 

DEFINE  MODULE 
X25-ACCESS 


P 


Use  the  DEFINE  MODULE  X25-ACCESS  command  to  specify  a  destination 
name  for  a  remote  DTE  in  the  permanent  data  base.  Destinations  defined  in 
the  permanent  data  base  apply  to  all  terminals. 

Format: 

DEFINE  MODULE  X25-ACCESS     DESTINATION  deat-name     NUMBER  dte-addreas 

where 


DESTINATION 

dest-name 

NUMBER 

dte-address 

Example: 


Specifies  a  destination  name  for  the  identified  remote 
DTE  address. 

Specifies  the  remote  DTE  address  to  be  associated  with 
the  specified  destination  name. 


CFE'^DEFINt  MODULE  ;;25-ACCESS  DESTINATION  PRSa/1  NUMBER  ^19746 

This  command  establishes  remote  DTE  219746  as  having  the  name  PRS44. 
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CFE 

DEFINE  MODULE 
X25-PROTOCOL 


Use  the  DEFINP:  MOOrLK  X2r>  I>H()TOC()L  command  t..  create  ..r  modify 
DTP",  group,  or  protocol  module  parameters  in  the  permanent  data  base. 


Format: 

DEFINE  MODULE  X25-PROTOCOL 


DTE  dte-address 
KNOWN  DTES 


I  GROUP  group- name 
KNOWN  GROUPS 


[CHANNELS  list] 
(COUNTER  TIMER  seconds] 
{LINE  line-id] 
MAXIMUM  CIRCUITS  count] 
STATE /OFfY] 

\oN  ;j 


i 


(DTE  dte-address] 
(NUMBER  group-number] 
(TYPE  BILATERAL] 


] 


'     (CALL  TIMER  seconds] 
(CLEAR  TIMER  seconds] 
(DEFAULT  DATA  bxte-count] 
(DEFAULT  WINDOW  block-count] 
(MAXIMUM  DATA  bxte-count] 
(MAXIMUM  CLEARS  count] 
(MAXIMUM  RESETS  count] 
(MAXIMUM  RESTARTS  count] 
(MAXIMUM  WINDOW  count] 
(RESET  TIMER  seconds] 
[RESTART  TIMER  seconds] 


where 


DTE-related  parameters: 


DTE 

dti'-addrrss 


Defines  parameters  tor  the  specified  local  DTK  only.  See 
RSX  II  PSI  Sciii  <irh-spr(ifi(  Informatum  tor  the  ad- 
dress format  on  vour  network. 


KNOWN  DTES         Defines  parameters  for  all  local  DTEs. 


CHANNELS 

list 


rorxTEH 

TIMER  seconds 


Specifies  a  list  of  logical  channel  numbers  to  be  used  for 
outgoing  calls  or  to  l)e  taken  by  incoming  calls.  Use  one 
or  more  1-  to  4-digit  channel  numbers  in  the  range  ol  1 
to  409").  I'se  a  hyj)hen  (-1  to  indicate  ranges;  use  a 
comma  (J  to  se|)arate  numbers  within  the  list.  Channel 
numbers  are  used  in  the  order  in  which  they  are  listed. 

Sets  a  timer  whose  expiration  causes  a  DTE  counter 
logging  event. 
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LINE  linr-id 

MAXIMl'M 
riHCl  ITS  cnunt 

STATK 


Specifies  a  particular  line  for  use  by  the  protocol  mod- 
ule. 

Specifies  the  maximum  number  of  circuits  the  module 
can  use  (ran^e:  1(t  to  ^IJ). 

Sets  the  local  DTK's  operational  state  to  i)VV  or  ON 
when  the  system  is  loaded. 


Group-related  parameters: 

Defines  parameters  for  the  specified  group  only. 


c.Horp 

KNOWN 

(iHorps 

DTK 

dtr-addrrss 

NIMHKR 

urnup-numbrr 


TYPK 
BIL.ATKHAL 


Defines  parameters  for  all  known  groups. 

Identifies  the  local  DTK  associated  with  the  specified 
group.  This  parameter  must  be  used  with  a  group  num- 
ber. 

Specifies  a  2-digit  closed  user  group  ((T*(i)  number  or  a 
4-digit  bilateral  closed  user  grouj)  (B(T'(i)  number 
(range:  0  to  9999:  you  can  omit  leading  zeroes).  This 
parameter  must  be  used  with  a  DTK  address. 


Required  when  the  specified  group  is  bilateral  (B(T'(i 
Protocol-related  parameters: 


C  ALL  TIMKH 

seconds 


(T.KAR  TIMKR 
.seconds' 


DKFAILT  D.ATA 

h\tr-ci)unt 


DKFAILT 
WINDOW 

block-count 

MAXIMIM 
DATA 

hxtf'-count 


Sets  a  timer  that  starts  when  a  request  is  transmitted  to 
set  up  a  virtual  circuit  and  whose  expiration  clears  the 
request  if  no  response  has  been  received  (range:  0  to 
25.") ) . 

Sets  a  timer  that  starts  when  a  re(^uest  is  transmitted  to 
clear  a  virtual  circuit  and  whose  expiration  causes  a 
retransmission  of  the  clear  request  if  no  response  has 
been  received  (range:  0  to  25o). 

Specifies  the  default  packet  size  (in  bytes)  for  all  SVCs. 
This  value  must  not  exceed  that  specified  for  the  MAXI- 
Ml'M DATA  parameter  and  must  be  a  power  of  2 
(range:  H)  to  1(124). 

Specifies  the  default  number  of  data  packets  that  can  be 
sent  over  an  SVC  before  you  have  to  wait  for  on  ac- 
knowledgment (range:  1  to  7).  This  value  must  not  ex- 
ceed that  specified  tor  MAXIMl'M  WINDOW. 

Specifies  the  maximum  packet  size  you  expect  to  re- 
ceive on  any  SVC.  This  value  must  be  at  least  o  bytes 
less  than  the  maximum  data  size  specified  for  PSI  lines 
(.see  DF.FINK  LINK)  and  must  be  a  {xiwer  of  2  (range: 
16  to  1024). 
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MAXIMl'M 
CLKAHS  count 

MAXIMIM 

KKSKTS  count 

MAXIMIM 
HKSTAHTS 
count 

MAXIMIM 
WINDOW  count 

RKSKTTIMKH 

seconds 


HP^STAHT 
TIMER  seconds 


Specifies  the  maxiimini  nuinher  ot  limes  that  the  proto- 
col module  can  try  clearing  a  virtual  circuit  (range:  0  to 


Specifies  the  niaxinium  number  of  times  the  protocol 
module  can  try  resetting  a  virtual  circuit  (range;  (i  to 


2:^5). 


Specifies  the  maximum  lunnber  of  times  the  protocol 
module  can  try  restarting  a  virtual  circuit  (range:  0  to 
255). 

Specifies  the  maxinuim  number  of  data  packets  that 
can  be  sent  over  an  S\'('  betore  you  have  to  wait  tor  an 
acknowledgment  (range:  1  to  7 1. 

Sets  a  timer  that  starts  when  a  reset  is  transmitted  and 
whose  expiration  causes  a  retransmission  of  the  reset 
message  if  no  response  has  been  received  (range:  0  to 
255). 

Sets  a  timer  that  starts  when  a  restart  is  transmitted 
and  whose  expiration  causes  a  retransmission  of  the  re- 
start message  if  no  response  has  been  received  (range:  (» 
to  255). 


Examples: 


CFE 


Nc     iluOULE        :'^     '^MVUIUCUL     KNUWN 


ATE    ON 


This  command  sets  the  state  of  all  local  DTKs  to  ON  when  the  system  is 
loaded. 


CFE 


•    MODULE      ;■"    '^ROTuuUL  nH;;iriun  (vestarts 


This  command  limits  to  20  the  number  of  times  the  protocol  module  is  to  try 
restarting  a  virtual  circuit. 
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CFE 

DEFINE  MODULE 
X25-SERVER 

DEFINE  MODULE 
X29-SERVER 


I'se  the  DEFINE  MODULE  X2o/X29-SERVER  commands  to  create  or  mod- 
ify server  module  parameters  in  the  permanent  data  hase. 

Restriction: 

It  you  specify  CALL  MASK  or  CALL  X'ALl'E,  you  must  specify  both,  and  the 
hcx-ioluc  of  each  must  contain  the  same  number  of  digits. 


Format: 


DEFINE  MODULE  rX25-SERVER\ 

\X29-SERVER/ 


where 

COrXTER  TIMER 

seconds 

MAXIMLM 
(TRCriTS  Lount 

DESTINATION 

dest-nanw 

KNOWN 
DESTIN.VnONS 

(\-\LL  MASK 

hvx-ialue 


TALL  VAUE 

hrx-Ldluc 


(COUNTER  TIMER  seconds] 
(MAXIMUM  CIRCUITS  count] 

'  DESTINATION  dest-name      fCALL  MASK  hex-value  Y 
KNOWN  DESTINATIONS     [^ALL  VALUE  hex-valuej 

(GROUP  group-name] 
<  (NUMBER  dte-address] 

(OBJECT  object-id] 
(PRIORITY  priority] 
(SUBADDRESSES  range]  ^ 


Sets  a  timer  whose  expiration  causes  a  server  module 
counter  logging  event. 

Specifies  the  maximum  number  of  circuits  that  the 
module  (that  is.  all  destinations)  can  use  (range:  1  to 
255). 

Defines  parameters  for  the  specified  destination  only. 


Defines  parameters  for  all  known  destinations. 

Specifies  the  mask  applied  to  incoming  call  data  be- 
fore it  is  tested  against  the  call  value  (default:  no 
mask).  Lse  a  hexadecimal  string  of  2  to  '.V2  digits 
(must  be  an  even  number  of  digits);  see  restriction. 

Specifies  a  string  of  information  used  to  test  incoming 
call  data  (default:  no  test  string).  I'se  a  hexadecimal 
string  ot  '2  to  .Vi  digits  (must  be  an  even  number  of 
digits);  see  restriction. 
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GROUP 

firoup-name 

NUMBER 

dte-address 

OBJECT 

object -id 


PRIORITY 

priority 


SUBADDRESSES 

range 

Examples: 


Specifies  the  name  of  a  closed  user  group  (CUG)  or  a 
bilateral  closed  user  group  (BCUG)  (default:  no 
group). 

Identifies  the  remote  DTE  that  originates  the  call  for 
the  specified  destination  (default:  no  DTE). 

Specifies  the  task  that  runs  when  an  incoming  call 
activates  it.  Use  either  an  object  name  or  an  object 
type  code  to  identify  the  task  (see  Appendix  B).  (Re- 
quired when  creating  a  destination.) 

Specifies  the  priority  of  the  destination.  This  is  used 
to  select  one  of  a  set  of  destination.';  for  which  the 
incoming  call  may  be  valid  (range:  0  to  255,  where  255 
is  the  highest  priority;  default:  128). 

Spe-  ifies  a  range  of  local  DTE  subaddresses  that  iden- 
tifies the  destination  for  the  incoming  call. 


CFE    T-'EFINE    MODULE    >;Z5-SErvnER    MAXIMUM    CIRCUITS    20 

This  command  limits  the  module  to  20  circuits. 

CFE  -F-FI,,E  MODULE  )<Z3-SER'.'ER  DESTINATION  TKVuZS  PRIORITV  5 

This  command  sets  the  priority  of  destination  TKY029  to  5. 
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CFE 

DEFINE  NODE 


Use  the  DEFINE  NODE  command  to  create  or  modify  parameters  in  the 
permanent  data  base  for  down-line  loading  and  up-line  dumping  to  the  speci- 
fied node  (see  Chapter  4).  If  you  are  not  performing  service  operations  on  the 
node,  NAME  is  the  only  meaningful  parameter. 

Restriction: 

You  must  specify  the  NAME  parameter  if  a  node  name  has  not  previously 
beenndefined  for  the  specified  node. 


Format: 

DEFINE  NODE  node-id 


[DIAGNOSTIC  FILE  file] 
[DUMP  ADDRESS  address] 
[DVMV  COV\T  number] 
[DUMP  FILE  file] 

[HARDWARE  ADDRESS  E-address] 
[HOST  node-id] 
[LOAD  FILE  file] 
[NAME  node-name] 
[SECONDARY  [LOADER]  file] 
[SERVICE  CIRCUIT  circuit-id] 
SERVICE  DEVICE  device-txpe] 
"SERVICE  NODE  VERSION  /PHASEIII 

\PHASEIV 
[[SERVICE]  PASSWORD  password] 
[TERTIARY  [LOADER]  file] 


}] 


where 


NODE  node-id 

DIAGNOSTIC 
FILE  file 

DUMP  ADDRESS 

address 

DUMP  COUNT 

number 

DUMP  FILE  file 


Specifies  the  node  for  which  parameters  are  to  be  cre- 
ated or  modified. 

(For  Ethernet  nodes  only)  Specifies  the  file  to  be  read 
when  the  node  is  down-line  loaded  and  requests  diag- 
nostics. 

Specifies  an  octal  address  in  memor>'  at  which  to  be- 
gin an  up-line  dump  of  the  node. 

Specifies  the  default  number  of  memory  units  to  up- 
line dump  from  the  node. 

Specifies  the  file  that  is  to  receive  a  copy  of  the  sys- 
tem at  the  time  of  the  crash  when  the  node  is  up-line 
dumped. 
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HARDWARE 
ADDRESS 

E- ad  dress 


HOST  node-id 
LOAD  FILE  file 

NAME 

node-name 

SECONDARY 
LOADER  file 

SERVICE  CIRCITT 

circuit-id 

SERVICE  DEVICE 

device-type 


SERVICE  NODE 
VERSION 

SERVICE 
PASSWORD 

passuord 

TERTIARY 
LOADER  file 

Example: 


Identifies  the  Ethernet  hardware  address  that  was 
originally  assigned  to  the  DEUNA  controller  for  the 
system  on  the  node.  This  address  is  used  during  oper- 
ations such  as  down-line  load  to  communicate  with 
the  system  hefore  it  has  set  up  its  physical  address. 

Specifies  a  host  node  for  all  service  operations  (de- 
fault: executor  node). 

Specifies  a  file  containing  the  system  software  for 
down-line  loading  to  the  node. 

Specifies  a  node  name  to  be  associated  with  the  node 
ID. 

Specifies  a  file  containing  secondary  loader  software 
for  down-line  loading  to  the  node. 

Specifies  the  circuit  to  be  used  for  down-line  loading 
and  up-line  dumping.  This  circuit  is  the  default  value 
for  the  VIA  parameter  of  the  LOAD  command. 

Specifies  the  node's  line  controller  for  the  ser\'ice  line 
over  which  the  operation  is  to  take  place.  Possible 
devices  are: 


DA 
DL 
DLV 


DMC 
DMP 
DMV 


DPV 

DU 

DUP 


DV 
DZ 
KDP 


KDZ 
QNA 
UNA 


Specifies  the  node  as  a  Phase  III  or  Phase  IV  (default) 
node. 

Specifies  the  password  required  to  trigger  the  boot- 
strap mechanism  on  the  node. 


Specifies  a  file  containing  tertiary  loader  software  for 
down-line  loading  to  the  node. 


CFE- DEFINE  NODE  Z05  NAME  DALLAS 


This  command  identifies  node  205  as  DALLAS. 
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DEFINE  OBJECT 


Use  the  DEFINE  OBJECT  command  to  create  a  new  object  or  to  modify 
object  parameters  in  the  permanent  data  base. 


Format: 

DEFINE  ()B.IE('T  type-vodr 


where 

OBJECT 

type-code 

COPIES 

number 


NAME 

object-name 

USER 


VERIFICATION 


rrOFIES  fmimhrr  V] 

L  \SIN(;LEJJ 

NAME  object -nann'] 

rSER   rDEFAlLT^.] 

:  \L0(,IN       J] 


I 


VERIFICATION   flNSPECT 

OFF 
ON 


Specifies  the  object  for  which  parameters  are  to  be  cre- 
ated or  modified.  Use  an  object  tvpe  code  from  Appendix 
B. 

Specifies  the  maximum  number  of  copies  of  a  task  that 
can  be  run  at  once  (range:  2  to  64).  Use  the  keyword 
SINGLE  (default)  if  the  task  is  not  muhicopy. 

Specifies  a  name  to  be  associated  with  the  object.  Use  any 
valid  RSX  task  nam«.  If  the  task  is  multicopy,  the  name 
must  end  with  $$$. 

Specifies  the  UIC  under  which  a  task  is  to  run  when  the 
object's  VERIFICATION  option  is  set  to  ON  or  IN- 
SPECT. 

DEFAULT  (Default)  The  task  runs  under  the  default 
UIC  under  which  it  was  built  or  in.stalled. 

LOGIN  The  task  runs  under  the  log-in  UIC. 

Specifies  the  degree  of  access  to  the  controlled  object. 

INSPECT  Allows  access  to  the  object  while  indicating 
to  it  whether  or  not  the  access  control  infor- 
mation is  valid. 


OFF 


ON 


(Default)  Allows  access  to  the  object  re- 
gardless of  the  validity  of  the  access  control 
information. 

Allows  access  to  the  object  only  for  inbound 
connections  with  valid  access  control  infor- 
mation. 
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Example: 


CFE  DEFINE  OBJE 


CATION  ON 


This  command  allows  access  to  object  2:i  only  to  inbound  connections  with 
valid  access  control  information. 
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CFE 
DEFINE  PROCESS 


P 


i  se  the  DKFINK  I'HOCKSS  command  to  moditv  process  paramt  ers  in  the 
permanent  data  base. 

Restriction: 

Oath  space  is  allocated  within  the  process's  addressing  space  only. 
Format: 

DKFINK    fFKOCKSS/jnurss-narrM^    MAXIMIM  CONTHOLI.KKS  count] 
\KN0\N  N  PHOCKSSKS  J  MAXIM'M  LINKS  numhir] 

rSTATK   Al.KAHKDyi 


where 

PKO(  KSS 

process-name 

KNOWN 
PK()(>:SSKS 

MAXIMIM 
(X)NTH()LLKF^S 

cnunt 

MAXIMIM 

LINKS 

number 


Modifies  parameters  tor  the  specified  i)rocess  only.  I'se  a 
process  name  trom  the  table  in  Chapte"  2. 

Modifies  parameters  tor  all  known  processes. 


Specifies  the  maximum  number  of  hardware  controllers 
•  range:  1  to  H4)  for  which  the  process  is  to  allocate  data 
space  (see  restriction). 

Specifies  the  maximum  number  of  lines  (range:  1  to  b4) 
for  which  the  process  is  to  allocate  data  space  (see  re- 
striction). 


srATE 


Exampie: 


Sets  the  operational  state  of  the  process  when  the  system 
is  loaded. 

CLKAHKI)     Not  available;  must  be  manually  loaded. 
^)N  Automatically  loaded  and  available. 


CFE  DEFINE  PROCESS  DMC  MA>aMU«  CONTROLLERS  f 

This  command  specifies  that  process  DM('  allocate  data  space  for  five  con- 
trollers. 
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CFE 


DEFINE  SYSTEM 


Use  the  DEFINE  SYSTEM  command  to  modify  Communications  Executive 
parameters  in  the  permanent  data  base  (see  Chapter  5). 

Format: 

DEFINE  SYSTEM       LARGE  BIFFER  SIZE  number] 

'[LOCATION]  /FIRSTFIT    V] 
\TOPDOVVNjJ 
MAXIMUM  CONTROL  BUFFERS  number] 
[MAXIMUM  LARGE  BUFFERS  number] 
[MAXIMUM  SMALL  Bl  FFERS  number] 
[MINIMUM  RECEIVE  BUFFERS  number] 
[POOL  BYTE-AREA  bxte-count] 
[POOL  NAME  pool-name] 
[POOL  PARTITION  partition-name] 


where 

LARGE  BUFFER 
SIZE  number 

LOCATIOX 


MAXIMUM 
CONTROL 
BUFFERS  number 

MAXIMUM  LARGE 
BUFFERS  number 

MAXIMUM  SMALL 
BUFFERS  numoer 


MINIMUM  RECEIVE 
BUFFERS  number 


Specifies  the  size  (in  bytes)  of  large  buffers  (range: 
for  DECnet.  192  to  4096;  for  PSI  only,  128  to  4096). 

Specifies  the  type  of  dynamic  memory  allocation 
for  any  process  whose  state  is  ON  in  the  permanent 
data  base. 


FIRSTFIT 


TOPDOVVN 

Specifies  the 
available  for 
use  (range:  1 

Specifies  the 
available  for 
use  (range:  1 

Specifies  the 
available  for 
use  (range:  1 
buffers). 


(Default)  Loads  the  processes  at  the 
first  available  space  that  is  large 
enough. 

Loads  the  processes  at  the  top  of  the 
partition. 

maximum  number  of  control  buffers 
Communications  Executive  svstem 
to  200). 

maximum  number  of  large  buffers 
Communications  Executive  svstem 
to  200). 

maximum  number  of  small  buffers 
Communications  Executive  .system 
to  the  maximum  number  of  control 


Specifies  the  minimum  number  of  receive  buffers 
available  for  Communications  Executive  system 
use  (range:  1  to  n;  n  is  the  maximum  num^  er  of 
large  buffers  minus  1). 
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POOL  BYTE-AREa 

byte-count 

POOL  NAME 

pool-name 

POOL  PARTITION 

partition-name 


Example: 


Specifies  the  number  of  bytes  needed  in  the  net- 
work pool  (range:  0  to  4095). 

Specifies  the  name  of  the  subpartition  to  be  cre- 
ated. Use  a  name  consisting  of  1  to  6  Radix-50 
characters. 

Specifies  the  name  of  the  partition  into  which  the 
network  pool  is  to  be  loaded.  Use  a  name  consist- 
ing of  1  to  6  Radix-50  characters. 


CFE>DEFINE  5V5TEM  MAXIMUM  SMALL  BUFFERS 


This  command  sets  the  maximum  number  of  smail  buffers  in  the  svstem  to 
50. 
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NCP 


KMX-DUMP 


Use  the  KMX-DUMP  command  to  dump  KMX  microcode  to  disk.  For  more 
information,  see  Chapter  9. 

NOTE 

This  command  halts  all  lines  on  the  KMX  device.  To  bring  the 
device  back  up  after  the  dump,  use  the  NCP  SET  LINE  com- 
mand to  set  the  state  of  all  lines  first  to  OFF  and  then  to  ON. 

Format: 

KMX-DUMP     USE  line-id     [FILENAME /i/ej 

where 

LINE  line-id     Specifies  a  KMX  line  (see  note  above).  Specify  line-id  in  the 
form  KMX-c-t^. 

FILENAME      Names     the     file     to     hold     the     binarv     dump     (default* 
fi^e  LB:[1,6]PSIKMXMEM.SYS). 

Example: 

NCP>Khi;;-DiJMP    LINE    ^r1;(-0-l     lB:[1  .G]KM)(MC.DMP 

This     command     dumps     the     microcode     of     KMX-0-1     to     file 
LB:[1,6]KMXMC.DMP. 
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CFE 


LIST  CIRCUIT 


Use  the  LIST  CIRCUIT  command  to  display  circuit  information  st(»ied  in  the 
permanent  data  base  (see  Chapter  3). 


Format: 

\KXOW\  CIRCU 


LIST  /CIRCUIT  circuit-id   \ 

JITSj 


where 

CIRCUIT  circuit-id        Displays  information  for  the  specified  circuit  only. 
KNOWN  CIRCUITS      Displays  information  for  all  known  circuits. 

Example: 

CFE;>LIST    CIRCUIT    DMC-0 

This  command  causes  the  svstem  to  display  static  information  for  circuit 
DMC-0. 
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CFE 


LIST  EXECUTOR 


I  se  the  LIST  EXECUTOR  command  to  display  executor  node  information 
stored  in  the  permanent  data  base  (see  Chapter  3). 


Format: 

LIST     EXECUTOR 
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CFE 

LIST  LINE 


Tse  the  LIST  LINE  command  to  display  line  information  stored  in  the  per- 
manent data  hase  (see  Chapter  3). 


.'ESj 


Format: 

LIST  /line  line-id 
I^KNOVVN  LIN 

where 

LINE  liru'-id  Displays  information  for  the  specified  line  only 

KNOWN  LINF^S      Displays  information  for  all  known  lines. 

Example: 


CFE  ,  I 5T  ^NOWN  LINES 


This  command  causes  the  system  to  display  static  information  for  every  line 
in  the  network. 


• 
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CFE 


LIST  LOGGING 


• 


I  se  the  LIST  LOCU'.IXd  command  t<.  display  lo^^in^  information  stored  in 
the  permanent  data  base  (see  ('hapter  .'^l. 


Format: 

LIST  fKNOWN  LOdCINc; 
LOdCINc;  CONSOLK 

L()(;(;iN(;  fii.k 

L()(J(;i.\{;  MOMTUK 


where 
KNOWN 

LO(;(;iN(; 
LOG(;iN(; 

(X)NSOLK 

LOCUHNC; 
FILK 

LO(;(;iN(; 

MONITOR 
Example: 


Displays  information  for  all  known  Io^r^i,i^r  components. 
Displays  information  for  the  io^^in^  constile  only. 
Displays  information  for  the  lo^^^Mn^  file  only. 
Displays  intormation  for  the  lo^'^nn^  monitor  program  onlv 


CFE>LIST  LOGGING  MONITOR  EVENTS 

This  command  causes  the  system  to  display  static  information  tor  the  L.^kimk 
monitor  program. 
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CFE 


LIST  MODULE 
X25-ACCESS 


I'se  the  LIST  MODULE  X25-ACCESS  command  to  display  remote  DTE 
destination  information  stored  in  the  permanent  data  base  (see  Chapter  3). 

Format: 

LIST  MODULE  X25-ACCESS  /DESTINATION  dest-name  \ 

\KNOWN  DESTINATIONS  j 

where 

DESTINATION        Displays  information  for  the  specified  destination  only. 
dest-name 

KNOWN  Displays  information  for  all  known  destinations. 

DESTINATIONS 


Example: 


CFE  LIST  MODULE  ;(Z5-ACCESS  DESTINATION  NVC^:: 

This  command  causes  the  system  to  display  static  information  for  destination 
NYC42. 
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CFE 


LIST  MODULE 
X25-PROTOCOL 


Use  the  LIST  MODIXE  X25-PROTOCOL  command  to  display  protocol 
module  information  stored  in  the  permanent  data  hase  (see  Chapter  8).  The 
information  may  he  qualified  by  either  DTE  or  group. 


Format: 

UST  MODULE  X25-PROTOCOL 


where 

DTE 

dtc-address 

KNOWN  DTES 

GROUP 

group-name 

KNOWN  GROUPS 
Example: 


VdTE  dte-address\ 
\KNOWN  DTES  / 

/group  group-nameX 

\known  groups  / 


Displays  information  for  the  specified  DTE  only. 

Displays  information  for  all  known  DTEs. 
Displays  information  for  the  specified  group  only 

Displays  information  for  all  known  groups. 


CFE     LIST    MODULE    ;;25  -  PROTOCOL     GrvQUP    LUG98 

This  command  causes  the  svstem  to  display  static  information  for  group 
CUG98. 
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CFE 

LIST  MODULE 

X25-SERVER 

LIST  MODULE 

X29-SERVER 


Use  the  LIST  MODULE  X25/X29-SERVER  commands  to  display  server 
module  information  stored  in  the  permanent  data  base  (see  Chapter  3).  This 
information  may  be  qualified  by  destination. 


Format: 

UST  MODULE  /X25-SERVER\ 
'\X29-SERVERj 

where 


/destination  dest-name  \ 
I^KNOWN  DESTINATIONS  J 


DESTINATION        Displays  information  for  the  specified  destination  only 

dest-name 

KNOWN  Displays  information  for  all  known  destinations. 

DESTINATIONS 

Example: 

CFE  LIST  MODULE  X29-SERUER  DESTINATION  PQUS 


This  command  causes  the  system  to  display  static  server  module  information 
for  destination  PG49. 
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CFE 


LIST  NODE 


Use  the  LIST  NODE  command  to  display  node  information  stored  in  the 
permanent  data  base  (see  Chapter  3). 


Format: 

LIST 


^T    TnODE  node-id      \ 
\K\0WN  NODESj 


where 

NODE  node-id  Displays  information  for  the  specified  node  only. 

KNOWN  NODES      Displays  information  for  all  known  nodes. 
Example: 

CFE.>LIST  NODE  B0S51 

This  command  causes  the  system  to  display  static  information  for  node 
B0S51. 
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CFE 
LIST  OBJECT 


Use  the  LIST  OBJECT  command  to  display  object  information  stored  in  the 
permanent  data  base  (see  Chapter  3), 

Format: 

LIST   foBJECT  t\pe-code  \ 
\ KNOWN  OBJECTS j 

where 

OBJECT  type-code        Displays  information  for  the  specified  object  only. 

Use  an  object  type  code  from  Appendix  B. 

KNOWN  OBJECTS      Displays  information  for  all  known  objects. 
Example: 

CFE>LI5T  KNOHN  OBJECTS 

This  command  causes  the  system  to  display  static  information  for  all  objects 
known  to  the  network. 
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CFE 
LIST  PROCESS 


Tse  the  LIST  PROCESS  command  to  display  pn,cess  information  stored  in 
the  permanent  data  base  (see  Chapter  :\). 

Format: 


AST    f PROCESS  pnnrss.namA 
\K.\()\VN  FROCKSSKS  / 


where 


PROCKSS 

process-name 

KNOWN 
PROCESSES 

Example: 


Displays  information  for  the  specified  process  only.  Cse  a 
process  name  from  the  table  in  (^hapter  2. 

Displays  information  for  all  known  [)rocesv 


vses . 


CPE 


"''OCESS    KDZ 


Th 


is  command  causes  the  system  to  display  static  process  information. 
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CFE 


LIST  SYSTEM 


I'se  the  LIST  SYSTKM  command  to  display  system  information  stored  in  the 
permanent  data  base  (see  Chapter  l\). 

Format: 

LIST     SYSTKM 


o 
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NCP 


LOAD  NODE 


Use  the  LOAD  NODE  command  to  down-line  load  a  specified  RSX-US 
remote  node  (see  Chapter  4). 

Format: 

LOAD  NODE  node-id      [ADDRESS  node-address] 

[FROM///e) 
[HOST  node-id] 
[NAME  node-name] 
[PHYSICAL  ADDRESS  E-address] 
[SECONDARY  [LOADER]  file] 
SERVICE  DEVICE  deiice-tvpe] 
SERVICE  NODE  VERSION  /PHASEIIlV] 

\PHASEIV/J 
[SERVICE!  PASSWORD  passu  ord] 
[TERTIARY  [LOADER]  file] 
[VIA  circuit-id] 

where 


HOST  node-id 

NAME 

node- name 

PHYSICAL 
ADDRESS 

E-address 


NODE  node-id  Specifies  the  node  to  be  down-line  loaded, 

ADDRESS 

node-address 

FROM  file 


Specifies  the  address  that  the  node  is  to  use  when  it 
comes  up. 

Specifies  the  file  specification  of  the  load  file  containing 
the  system  software  to  be  down-line  loaded. 

Specifies  the  default  host  that  the  node  is  to  use  when  it 
comes  up. 

Specifies  the  node  name  that  the  node  is  to  use  when  it 
comes  up. 

(For  Ethernet  nodes  only)  Identifies  the  Ethernet  physi- 
cal address  that  the  node  currently  uses  to  identify  itself. 
(Required  for  Ethernet  circuits  if  the  hardware  address 
parameter  has  not  been  specified  in  the  volatile  data 
base:  see  SET  NODE.) 
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SECONDARY 
LOADER  file 

SERVICE 
DEVICE 

device-type 


SERVICE  NODE 
VERSION 

SERVICE 
PASSWORD 

password 


TERTIARY 
LOADER  file 

VIA  circuit-id 
Examples: 


Specifies  the  file  specification  of  a  secondary  load  pro- 
gram to  be  down-line  loaded. 

Specifies  the  node's  line  controller  for  the  service  line 
over  which  the  operation  is  to  take  place.  Possible  de- 
vices are: 

DA  DMC  DPV  DV  KDZ 
DL  DMP  DU  DZ  QNA 
DLV   DMV   DUP   KDP   UNA 

Specifies  the  node  as  a  Phase  III  or  Phase  IV  (default) 
node. 

Specifies  the  password  required  to  trigger  the  bootstrap 
mechanism  on  the  node. 


NOTE 

If  you  do  not  want  a  password  echoed  to 
your  terminal  while  you  enter  it.  press  the 
RETURN  key  after  the  keyword  PASS- 
WORD. NCP  prompts  for  the  password 
and  turns  off  echoing  unt'l  the  next 
prompt. 


Specifies  the  file  specification  of  a  third  load  program  to 
be  down-line  loaded. 

Specifies  the  circuit  over  which  the  load  is  to  take  place. 


NCP.-LOAD    NODE    ATLZ5 


This  command  loads  node  ATL25.  Default  load  parameters  are  obtained  from 
the  volatile  data  base. 


NCP>LOAD    NODE    ATLZS    '.' I A    Df1C-l 


This  command  loads  node  ATL25  bv  wav  of  circuit  DMC- 1, 
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NCP 


LOAD  VIA 


Tse  the  LOAD  VIA  command  to  down-line  load  an  RSX-llS  remote  node  via 
the  specified  circuit  (see  Chapter  4). 

Format: 

LOAD  VIA  circuit-id      [ADDRESS  node-address] 

[FROM  ///('] 
[HOST  node-id] 
[NAME  node-name] 
[PHYSICAL  ADDRESS  E-address] 
[SECONDARY  [LOADER]  file] 
[SERVICE  DEVICE  device-txpe] 
[SERVICE  NODE  VERSION  /PHASEIini 
L  VPHASEIV/J 

[[SERVICE]  PASSWORD  password] 
[TERTIARY  [LOADER]  file] 

where 

VIA  circuit-id  Specifies  a  circuit  over  which  the  load  is  to  take  place. 


ADDRESS 

node-address 

FROM  file 


HOST  node-id 

NAME 

node-name 

PHYSICAL 
ADDRESS 

E- address 


SECONDARY 
LOADER  file 

SERVICE 
DEVICE 

device-type 


Specifies  the  address  the  node  is  to  use  when  it  comes 
up. 

Specifies  the  file  specification  of  the  lop.J  file  containing 
the  system  software  to  be  down-linr  loaded. 

Specifies  the  default  host  that  the  node  is  to  use  when  it 
comes  up. 

Specifies  the  node  name  that  the  node  is  to  use  when  it 
comes  up. 

(For  Ethernet  nodes  only)  Identifies  the  Ethernet  physi- 
cal address  that  the  node  currently  uses  to  identify  itself 
(Required  for  Ethernet  circuits  if  the  hardware  address 
parameter  has  not  been  specified  in  the  volatile  data 
base;  see  SET  NODE.) 

Specifies  the  file  specification  of  a  secondary'  load  pro- 
gram to  be  down-line  loaded. 

Specifies  the  node's  line  controller  for  the  service  line 
over  which  the  operation  is  to  take  place.  Possible  de- 
vices are: 


DA  DMC  DPV  DV 
DL  DMP  DU  DZ 
DLV      DMV       DUP       KDP 


KDZ 
QNA 
UNA 
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SERVICE  NODE      Specifies  the  node  as  a  Phase  III  or  Phase  IV  (default) 
VERSION  node. 


SERVICE 
PASSWORD 

password 


Specifies  the  password  required  to  trigger  the  bcwjtstrap 
mechanism  on  the  node. 


NOTE 

If  you  do  not  want  a  password  echoed  to 
your  terminal  while  you  enter  it,  press  the 
RETURN  key  after  the  keyword  PASS- 
WORD. NCP  prompts  for  the  password 
and  turns  off  echoing  until  the  next 
prompt. 


TERTIARY 
LOADER  file 

Example: 


Specifies  the  file  specification  of  a  third  load  program  to 
be  down-line  loaded. 


NCP>LOAD    i.'IA    DMC-0 


This  command  loads  the  node  connected  to  the  executor  node  via  circuit 
DMC-0. 
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NCP 


LOOP  CIRCUIT/LINE 


Use  the  LOOP  CIRCUIT  command  to  test  a  DECnet  or  Ethernet  circuit  in 
the  network.  Use  the  LOOP  LINE  command  to  test  a  PSI  line  in  the  network. 
Each  ct)mmand  causes  test  blocks  of  data  to  be  transmitted  over  the  specified 
line  or  circuit.  See  Chapter  3  for  more  information  on  loopback  testing. 

When  testing  an  Ethernet  circuit,  you  can  use  the  HELP  parameter  to  specify 
a  third  node  to  assist  with  the  test.  If  you  specify  the  HELP  parameter  vou 
must  also  specify  the  PHYSICAL  ADDRESS  and  ASSISTANT  PHYSICAL 
ADDRESS  parameters.  (Note:  They  cannot  be  multicast  addresses.)  If  you 
do  not  know  the  addresses,  you  can  use  the  NODE  and  ASSISTANT  NODE 
parameters  instead. 


Format: 
LOOP  r  LINE  line-id 

CIRCUIT  anuit-id 


HELP   rPULL 

<  RECEIVE 
^TRANSMIT 
PHYSICAL  ADDRK 
^ASSISTANT  VH\ 
"N'ODP]  K-nodv-nami 
ASSISTANT  NODP:  E-nndc-nam 


iP^SS  E-addrrss  ~| 

SICAL  ADDRESS  E-addn'ss\ 

.] 


[COUNT  count] 
[LENGTH  lernith] 
^\YYH  fMIXED 
<  ONES 
IZEROES 


>  — 


where 

LINE  line- id 

CIRCUIT 

circuit-id 


Specifies  a  PSI  line  for  loopback  testing. 
Specifies  a  circuit  for  loopback  testing. 
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HFLP 

help- type 


Specifies  the  dejjree  to  which  a  third  node  is  to  assist  with 
an  Ethernet  loop  circuit  test. 


PHYSICAL 
ADDRESS 

m -address 

ASSISTANT 

PHYSICAL 

ADDRESS 

E-nddress 

NODE 

E-node-name 

ASSISTANT 
NODE 

K-nade-rmme 

COUNT  count 


LENCITH 

length 


WITH 


FULL 

RECEIVE 

TRANSMIT 


The  assisting  node  is  to  both  receive  and 
transmit  the  test  packet  (see  the  example). 

The  assisting  node  is  only  to  receive  the  test 
packet. 

The  assisting  node  is  only  to  transmit  the 
test  packet. 


If  you  specify  HELP,  vou  must  al.so  specifv  either  the  PHY- 
SICAL ADDRESS  and  ASSISTANT  PHYSICAL  AD- 
DRESS parameters  or.  if  the  addresses  are  not  known,  the 
NODE  and  ASSISTANT  NODE  parameters. 

Specifies  the  physical  address  (not  a  multicast  address)  of 
an  Ethernet  node  that  is  to  be  the  destination  of  a  loop  test 
mes.sage. 

Specifies  the  physical  address  (not  a  multicast  address)  of 
an  Ethernet  node  that  is  to  assist  in  the  loop  circuit  test. 


Specifies  the  name  of  an  Ethernet  node  that  is  to  be  the 
destination  of  a  loop  test  message. 

Specifies  the  name  of  an  P^thernet  node  that  is  to  assist  in 
the  loop  circuit  test. 

Specifies  the  number  of  blocks  to  be  sent  during  loopback 
testing  (range:  1  to  Cv^r)^^'^■,  default:  1  block  is  looped). 

Specifies  the  length  (in  bytes)  of  blocks  to  be  sent  during 
loopback  testing.  When  testing  over  the  Ethernet,  the 
length  must  be  a  decimal  integer  in  the  range  of  ;^2  to  1484. 
Otherwi.se,  the  length  must  be  a  decimal  integer  in  the 
range  of  1  to  n,  where  n  must  be  less  than  the  smaller  of 
either  the  local  looper  buffer  size  or  the  remote  mirror  buffer 
size  (default:  40  bytes). 

Specifies  the  type  of  binary  information  to  be  sent  during 
testing  (default-  MIXED  -  a  combination  of  ones  and 
zeroes). 
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Example: 

iJlro    X;^'     ^^^'^^^^     UNA-0     HELP    FULL     PmvSICAL     ADDRESS    AA  . 

NCP    ASSISTANT    PHYSICAL     ADDfyESS    AA  '4.00-0a-A9 

This  n.mmaiHi  (shown  in  lontinuation  lorniat)  tests  rircuit  I'N'A  0  with  the 
assistance  ol  the  node  spedfied  in  ASSIS  TAN"!'  }>HVS1('A'  M)I)HKSS.  The 
initiating  node  semis  a  lest  packet  to  the  assisting'  m.de.  The  assisting  node 
processes  the  packet  and  passes  the  packet  to  the  destination  node  specified 
in  I'HVSICAI.  ADDHKSS.  The  destination  node  receives  the  packet  and 
transmits  the  packet  hack  to  the  assisting  node.  The  assisting  n.ule  then 
returns  the  packet  to  the  initiating  node. 


Mil 
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NCP 
LOOP  EXECUTOR/NODE 


NP 


I'se  the  LOOP  NODE  command  to  test  a  node  in  the  network.  You  can 
include  access  control  information  if  the  node  requires  it.  If  you  are  testing  the 
executor  node,  you  can  use  the  LOOP  EXECUTOR  command.  Either  com- 
mand causes  test  blocks  of  data  to  be  transmitted  to  the  specified  node.  See 
Chapter  3  for  more  information  on  loopback  testing. 


Format: 

LOOP  /NODE  nndf-idlavv- 
\EXECrTOR 


c»n-inf(>]\    'COl'NT  count] 
)     ;LEN(;TH  Um^th] 
"WITH    fMIXED 

-{ones 
Ueroes 


where 

NODE  nnde-id 
ace- con-info 
EXECITOR 
COUNT  count 

LENGTH 

length 


WITH 


Specifies  a  node  for  loopback  testing. 

Specifies  access  control  information,  if  required. 

Specifies  the  executor  node  for  loopback  testing. 

Specifies  the  number  of  blocks  to  be  sent  during  loopback 
testing  (range:  1  to  65535:  default:  1  block  is  looped). 

Specifies  the  length  (in  bytes)  of  blocks  to  be  sent  during 
loopback  testing.  When  testing  over  the  Ethernet,  the 
length  must  be  a  decimal  integer  in  the  range  of  32  to  1484. 
Otherwise,  the  length  must  be  a  decimal  integer  in  the 
range  of  1  to  n.  where  n  must  be  less  than  the  smaller  of 
either  the  local  looper  buffer  size  or  the  remote  mirror  buffer 
size  (default:  40  bytes). 

Specifies  the  type  of  binary  information  to  be  sent  during 
testing  (default:  MIXED  -  a  combination  of  ones  and 
zeroes). 


Example: 


NCP     .OOP    NODE    NYC    COUNT     10 

This  command  loops  10  blocks  of  mixed  test  messages  to  remote  node  NYC. 
Each  block  is  40  bvtes. 
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CFE 


PURGE  CIRCUIT 


I  se  the  PrRCJK  CIRCriT  command  to  zero  the  specilied  PSI  circuit  counter 
timer(s)  in  the  permanent  data  base. 

Format: 

PURGE  /CIRCUIT  circuit-id  \  COUNTER  TIMER 
\  KNOWN  CIRCUITS/ 


where 

CIRCriT 

circuit-id 

KNOWN 

riRcrrrs 


Zeroes  the  counter  timer  for  the  specified  circuit  onlv 


Zeroes  the  counter  timers  for  all  known  circuits. 


Example: 


CFE  PURGE  KNOWN  CirvCUITS  COUNTETv  TiMEp 

This  command  zeroes  the  counter  timers  for  all  known  PSI  circuits. 
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CFE 

PURGE  LINE 


Tse   the  PrR(iF'   LINK  command   to  zero  the  specitied   PSI  line  counter 
timer(s)  in  the  permanent  data  base. 

Format: 

PURGE  TlINE  line-id        \   COUNTER  TIMER 


I^KNOWN  UNES 


} 


where 


LINE  Zeroes  the  counter  timer  for  the  specitied  line  only 

linr-id 

KNOWN      Zeroes  the  counter  timers  for  all  known  lines. 
LINES 


Example: 


CFE>PURGE  LINE  SDP-n  COUNTER  TIMER 


This  command  zeroes  the  counter  timer  for  line  SI)P-(). 
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CFE 

PURGE  LOGGING 


I  se  the  F^rRCiK  L0(J(1I\(1  command  to  remove  the  specified  l(>^^inK  event 
parameters  from  the  permanent  data  base. 


Format: 


prR(;K  rkNowx  loccinc, 
Il()(;(;in(;  consolk 

1    I    /^/^/'fV/^      T^ff     f 


L()(;(;iN(;  filk 
L()(;(;i\(;  monitor 


ALL  KVKNTS 
FA'KN'rs  Itst 
KNOWN  FAKNTS 


where 


KNOWN 
LOCiCHNG 

LO(;(;iN(; 

CONSOLE 

LOGOINO  FILK 

LOOCilNG 
MONITOR 

ALL  EVENTS 


EVENTS  list 


KNOWN 
EVENTS 

Example: 


Removes  parameters  for  all  known  lofj^nng  components. 

Removes  parameters  tor  log^in^  to  the  console. 

Removes  parameters  for  log^in^  to  a  file. 

Removes  parameters  for  logging  to  a  monitor  program. 

Removes  parameters  for  all  logging  event  classes  and 
types. 

Removes  parameters  for  the  logging  event  class  and 
type(s)  specified  in  list.  See  (Tiapter  2  for  the  event  list 
format. 

Removes  parameters  for  all  logging  events  that  I)P]G- 
net-RSX  can  generate. 


CFE  PURGE  KNOWN  LOGGING  ALL  E'JENTB 

This  command  removes  all  cla.sses  and  types  of  events  for  all  known  logging 
components. 
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CFE 

PURGE  MODULE 
X25-ACCESS 


I'se  the  PIHCIK  MODILK  X'ln-ACVKSS  command  to  remove  parameters 
for  the  speiit'ied  destination(s)  from  the  permanent  data  base. 

Format: 

PURGE  MODULE  X25-ACCESS  /DESTINATION  dest-name  \  ALL 

\known  destinations/ 

where 


DKSTINATION 

dvst-nnmc 

KNOWN 
DKSTINATIONS 

ALL 


Example: 


Removes  parameters  for  the  specified  destination  only. 

Removes  parameters  for  all  known  destinations. 

(Required)  Removes  all  parameters  for  the  specified  des- 
tinationls). 


CFE  PU'^GE  MODULE  ;:25-ACCE5S  DESTINATION  DALLAS  ALL 

This  command  removes  destination  DALLAS  and  all  associated  parameters. 
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CFE 

PURGE  MODULE 
X25-PROTOCOL 


I'se  the  PrmJE  MODl'LE  X'^fv  PROTOrOL  command  to  zero  the  counter 
timer(s)  for  the  specified  DTEls)  or  to  remove  all  parameters  for  the  specified 
I)rE(s)  or  group(s)  from  the  permanent  data  base. 


Format: 
PURGE  MODULE  X26-PROTOCOL 


' /DTE  dte-addressX       /aLL 
\KNOWN  DTES  J       )COUNTER  TIMER 

ICgKOVP groupnameX    ALL 
[\KNOWN  GROUPS  / 


:} 


where 

DTE 

dtv-acidress 


KNOWN  DTES 

(iROrP 

^roup-namc 

KNOWN  (mOl'PS 
ALL 


Clears  the  specified  DTE  only.  He  aware  that  purging 
a  DTP]  removes  all  PV(\s  and  (TCls  associated  with  it 
and  purges  them  from  the  permanent  data  l)ase. 

Clears  all  known  DTEs. 

Removes  parameters  for  the  specified  group  only. 

Removes  parameters  for  all  known  groups. 

Removes  all  parameters  for  the  specified  DTE(s)  or 
group!  s). 


COUNTER  TLMER      Zeroes  the  counter  timer(s)  for  the  specified  DTEls), 
Example: 

CFE  PURGE  MODULE  ;(Z5  -  PROTOCOL  GROUP  CUCLlll  ALL 

This  command  removes  parameters  for  group  CL'GlU. 
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CFE 

PURGE  MODULE 
X25-SERVER 

PURGE  MODULE 
X29-SERVER 


1st'  the  PIKCK  MODILK  .jr,  \i.h)  SKR\  KH  (r.mmands  tn  zen.  the 
counltT  tinuT  or  to  rcniovf  [)Mranu'(('rs  tor  the  spt'titifd  (lest inal ioiiis)  tn»m 
tlu'  pfrniaiu'tif  data  f)asf. 


Format: 


PURGE  MODULE  /X25-SERVER\ 

\X29-SERVERJ 


COUNTER  TIMER 


TdESTINATION  dest-name  I     ALL 
\kNOWN  DESTINAllON 


me  1 
NSJ 


where 

corxiKK 

I'lMKH 

DKSriNA'nON 

drst-namr 

KNOWN 
DHSriNATIONS 

ALL 


Example: 


Zen)e>  the  server  module  counter  timer. 


Removes  j)aramelers  tor  the  >j)e{ilie(l  destination  onlv 


Removes  [)arameters  tor  all  known  destinations. 


(Required  when  you   .^peeity   a  destination   parameter) 
Removes  all  parameters  tor  the  specified  destination!  si. 


CFE  PUr^GE  MODULE  ::?-SERoEry  DESTINATION  ALBANY  ALL 

'il-iis  eommand  removes  destination  ALBANY  and  all  assoi'iated  i)arameters. 
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CFE 


PURGE  NODE 


I  se  the  !H'H(iK  NODK  tommand  to  remove  specified  node  parameters  from 
the  permanent  data  base  on  the  local  node. 

Format: 

PIHCK   fNODKnof/r/Vy      \:ALL] 

I^KNOWN  NODKSj  IDIACIXOSTK'  FILK! 

iDlMP  ADDRKSS; 
iUlMP  COINT] 
[DIMP  FILE] 
IHARDWAHE  ADDRKSS] 
iHOSTi 
[LOAD  FILE] 

iSECOXDARV  :LOADER;i 
.SERVICE  CIR(H1T1 

iSERvicE  device: 

liSERVICE!  PASSWORD! 
[TERTIARY  [LOADER!! 


where 

NODE  nodr-id 
KNOWN  NODES 
ALL 


DIAGNOSTK^ 
EILE 

Dl'MP  ADDRESS 

Dl/MP  COUNT 

DUMP  FILE 

HARDWARE 
ADDRESS 

HOST 

LOAD  FILE 


Removes  parameters  for  the  specified  node  only. 

Removes  parameters  for  all  known  nodes. 

Removes  all  parameters  for  the  specified  node(s).  If 
you  specify  ALL,  you  cannot  mclude  any  other  param- 
eters. 

Removes  the  identification  of  the  down-line  load  diag- 
nostics file. 

Removes  the  node's  up-line  dump  address. 
Removes  the  up-line  dump  count. 
Removes  the  up-line  dump  file  identification. 
Removes  the  Ethernet  address  of  the  system  hardware. 

Removes  the  host  node  identification. 
Removes  the  down-line  load  file  identification. 
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SECONDARY 
LOADER 

SERVICE 
CIRCriT 


Removes  the  secondary  down-line  load  tile  identifica- 
tion. 

Removes   the  circuit   parameter  associated  with   the 
node  for  down-line  load  operations. 


SERVICE  DEVICp]      Removes  the  service  device  type. 


SERVICE 
PASSWORD 

TERTIARY 
LOADER 


Removes  the  password  parameter  required  to  trigger 
the  bootstrap  mechanism. 

Removes  the  tertiarv  down-line  load  file  identification. 


Example: 


CFE     PUrvGE    NODE    BOS    ALL 


This  command  removes  loop  node  BOS  from  the  data  base. 
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CFE 


PURGE  OBJECT 


Use  the  PrR(]K  OBJP"]rT  command  to  remove  all  parameters  tor  the  speti 
tied  object (s)  from  the  permanent  data  base. 


1- 


Format: 

PI 


'R(;K   foB-IKCT  ,>hnrt.t\pA 
I^KNOVVN  OBJECTS  J 


where 

OBJECT        Removes  parameters  for  the  specified  object  only.  Use  an  object 
ohjcct-type     type  code  from  Appendix  B. 

KNOWN        Removes  parameters  for  all  known  objects. 
OBJECTS 

Example: 

CFE     PURGE    OBJECT    200 

This  command  removes  all  parameters  for  object  200. 
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NCP/VNP 


NP 


SET  ALIAS 


Use  the  NCP  SET  ALIAS  command  to  specify  an  alias  name  for  a  node  in  the 
volatile  data  base.  Use  the  VNP  command  to  do  the  same  with  the  system 
image  tile. 

Format: 

SET    ALIAS  alias-namv    DESTINATION  dvst-nodv    [[SCOPE]  svopv] 
where 


ALIAS 

alia,s-name 

DRSTIXATIOX 

di'st-node 

SCOPE  scope 
Example: 


Specifies  the  alias  name  to  be  assigned  to  the  destination 
node.  Alias-name  consists  of  1  to  6  alphanumeric  charac- 
ters, including  at  least  1  alphabetic  character. 

Specifies  the  destination  node  and  any  access  control 
parameters  associated  with  this  alias  for  that  node.  See 
Chapter  2  for  the  access  control  format. 

See  definition  in  Section  6.'). 2. 


NCP-SET  ALIAS  DOTvCH?  DESTINATION  B0SZ7  /  DA'.' I  5  ,' SNA  I  L 
NCP>SCOPE  TErvMINAL  '^122: 


RET' 


This  command  (shown  in  continuation  format)  sets  alias  DORCHo  to  termi- 
nal TT22:  on  node  BOS27.  DAVIS  is  the  account  name,  and  SNAIL  is  the 
password. 
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NCP/VNP 


P 


SET  CIRCUIT 


Use  the  NCP  SET  (TIUl'IT  command  to  create  or  modify  specified  circuit 
parameters  in  the  volatile  data  base.  I'se  the  V\P  command  to  do  the  same 
with  the  system  image  file. 

Restriction: 

The  VNP  SET  CIRCriT  command  is  invalid  for  PSI  circuits. 
Format: 


SKT  [cmCllT  arvuit-id  \ 

I^KNOWN  riRrriTsj 


where 

(TRcrrr 

circuit -id 

KNOWN 
CIRCllTS 

COST  cost 


COUNTER 
TIMER  seconds 

HELLO  TIMER 

seconds 

MULTIPOINT 
ACTIVE 

active-ratio 

OWNER 


■COST  cost] 

(COUNTER  TIMER  seconds] 

:HKLL()  timer  seconds] 
iMlLTIPOINT  ACTIVE  mtiir-mtio] 
OWNER  rnLX^ll 

SERVICE  /disable!] 

\ ENABLE  JJ 

l^TATE  fOFF 

^ON 

(.service 

[TRIBUTARY    tnb-addn'ss 


Sets  parameters  for  the  specified  circuit  onlv 


Sets  parameters  for  all  known  circuits. 

Specifies  the  routing  cost  of  the  circuit  (range:  1  to  25). 
Messages  will  travel  between  nodes  along  the  path  with 
the  smallest  total  cost. 

(Valid  for  X2o-SERVER  circuits  only:  invalid  for  VNP) 
Sets  a  timer  whose  expiration  causes  a  PSI  circuit  counter 
logging  event. 

Specifies  the  frequency  of  routing  hello  messages  sent  to 
adjacent  nodes  over  the  circuit. 

(Valid  only  for  circuits  with  multipoint  software)  Speci- 
fier the  rate  at  which  a  tributary  in  the  active  multipoint 
state  is  polled  (range:  1  to  255). 

Specifies  th?  circuit  owner. 

DLX      DLX  (See  the  DECnet-RSX  Programmer's  Refer- 
ence Manual.) 


XPT      DECnet 


SERVICE 


STATE 


TRIBl'TARV 

trih-addrcss 

Example: 


Specifies  whether  the  circuit  is  enabled  or  disabled  Cor 
down-line  loading  and  loopback  testing. 

Sets  the  circuit's  operational  state.  For  circuits  owned  by 
the  executor,  the  state  ot  the  corresponding  lines  must  be 
ON. 

OFF  \ot  available. 

ON  Available  for  normal  u.se. 

SERN'ICE      Available  Cor  service  operations  only. 

Specifies  the  data  link  physical  tributary  address  of  the 
multipjoint  circuit  (range:  1  to  2rvi). 


NCP  SET  CiryCUIT  KDZ-1-3  STATE  OFF 


This  command  sets  the  state  oC  circuit  KI)Z-1  ;?  to  OFF 


6-80        DECnet-RSX  System  Managers  Guide 


NCP/VNP 


SET  EXECUTOR 


I  se  the  \CV  SKr  KXHCl'TOH  rornniaiid  to  crcatt'  or  niodity  t'xccutor  node 
parameters  in  the  volatile  data  base.  I'se  the  VNP  command  to  do  the  same 
with  the  system  image  tile. 


Format: 

SKT  KXKdTOH 


where 

HOST  nndr-id 

rf:cp:ivk 
password 

passu- ord 

HOITJNO 
TIMKR  '^rcfmds 

SKI  ;M  FAT 
BITFER  SIZE 

number 


HOST  ^('-(/r.,fy: 

HK(  KIVK  PASSWORD  passu, ,rd 
ROITINC  TIMKR  srcnnds] 
SKOMKNT  HIKFKR  SIZK  numhrr 
"T^TAIK   rOFF  ^"^ 

ON     r/FIXKD       Yl 

Lti  nfixkd/J 

.SHIT 
(SUBADDRESSES  range] 

;TRA.\SMrr  }\ASS word  passu, >rd' 
rVKRIFICATION    STATK    /OFF^l 


Specifies  the  host  node  identification  for  down-line 
load,  trigger,  and  up-line  dump. 

Specifies  a  1-  to  S-character  AS(TI  pa.ssword  that  the 
executor  expects  to  receive  during  initialization  with  an 
adjacent  node. 

Sets  a  timer  whose  expiration  forces  a  routing  update  on 
non-Kthernet  circuits. 

Specifies  the  maximum  size  of  transmit  buffers  (in 
bytes).  thereb>  controlling  the  size  of  the  XSP  message 
segment  to  be  sent.  This  value  is  the  maximum  size 
message  that  the  Knd  Communications  layer  can 
transmit,  it  does  not  include  routing  or  data  link  over- 
head (range:  1  to  4096:  default:  IS  bytes  less  than  the 
large  buffer  size  specified  in  the  DKKIXK  SVSTKM 
command).  The  segment  buffer  size  can  never  be 
greater  than  the  large  buffer  size  minus  18  bvtes. 
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STATK 


SIBADDRESSKS 

TRANSMIT 
PASSWORD 

password 

VERIFICATION 
STATE 


ON 


SHIT 


Sets  the  operational  state  ot  the  executor  node.  This 
parameter  lannot  he  specified  it'voii  use  the  TELL  pre- 
fix. 

OFF  Allows  no  new  logical  links;  terminates  exist- 
ing links;  forces  the  release  of  all  mailhoxes  as 
quickly  as  possihle. 

Allows  normal  logical  link  activity.  When  us- 
ing V'NF  to  set  the  executor  state  to  ON  for 
DECne^-llS  systems,  you  can  specify  one  o* 
the  following  task  states  lor  NTINIT  after  it 
has  initialized  the  node: 

FIXED  (Default)    NTINIT    remains    in 

memory. 

I  NFIXED     NTINIT  is  removed  from  mem- 
ory. 

(Invalid  for  VNF)  Allows  no  new  logical  links; 
does  not  destroN  existing  links;  goes  to  the 
OFF  state  when  all  logical  links  terminate  and 
all  mailboxes  are  released. 

(Invalid  for  VNF)  Specifies  a  range  of  local  DTE  suliad- 
dresses  that  are  valid  on  any  PSI  circuit  for  incoming 
calls  to  the  executor  node. 

Specifies  a  1-  to  H-character  ASCII  password  that  the 
executor  sends  to  the  adjacent  node  during  a  node  ini- 
tialization sequence. 

Sets  the  logical  link  access  control  verification  state  for 
the  executor  node. 

OFF  The  executor  node  does  not  verify  access  control 
c)n  any  incoming  connect  requests. 

ON  The  executor  node  verifies  access  control  on  all 
incoming  connect  requests  accordmg  to  the  op- 
tions set  for  each  object  (see  the  discu.ssion  of 
access  control  in  Chapter  2*. 


Example. 


NCP     -ET    EXECUTOR    HOST     12 


This  command  sets  node  12  as  the  host  node  for  down-line  load,  trigger,  and 
up-line  dump  operations. 


• 
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NCP 


HP 


SET  EXECUTOR  NODE 


Use  the  SRT  KXPXHJTOR  NODE  command  to  set  a  default  executor  for  all 
NCP  corr.mands.  This  causes  subsequent  remotely  executable  NCP  com- 
mands to  be  executed  at  the  specified  destination.  Appendix  A  lists  all  NCP 
commands  and  flags  those  that  are  not  remotely  executable. 

Restriction: 

You  cannot  use  the  TKLL  prefix  with  this  command  (that  is,  this  command  is 
not  remotely  executable). 

Format: 

SKT  EXKCUTOR  NOOK  nodc-idlacc-con-info] 
where 


NODE  node-id 


ace -con-info 


Exampie: 


Specifies  the  node  (by  address,  alias,  or  name)  that  is  to 
serve  as  the  executor  for  subsequent  NCP  commands. 

Specifies  access  control  information  (if  required   by  the 
node). 


NCP>5ET  EXECUTOR  NODE  ATL25 / NEL SON / PAT 

This  command  sets  node  ATL25  (user  NELSON,  password  PAT)  to  executor 
status.  Future  commands  will  be  sent  to  ATL25  Tor  execution. 
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NCP/VNP 


SET  KNOWN  LINES 


Tse  the  NCP  SKT  KNOWN  LINKS  command  either  to  load  all  known  lines 
and  create  their  associated  parameters  in  the  volatile  data  base  or  to  create  or 
modify  parameters  in  the  data  base  for  all  known  lines  that  are  already 
loaded.  I'se  the  VNP  command  to  do  the  same  with  the  system  image  file. 

Restriction: 

Except  for  STATE,  the  options  allowed  when  you  are  loading'  lines  are  differ- 
ent from  those  used  to  create  or  modify  parameters  for  lines  that  are  already 
loaded.  Any  lines  that  you  are  loading  must  be  in  the  CLEARED  state.  Lines 
that  are  already  loaded  must  be  in  the  ON  or  OFF  states  (that  is  not 
(M.EAKED). 


Format: 

SKT  KNOWN  LINKS 


Loaditifi  options: 


Loaded  options: 


[state     fOFF'^'l 

[ALL] 

[DEAD  TIMKR  millisvamds] 
iDKLAV  TIMKR  millisrconds] 
l)l'PLKX  /FLLL^I 

\halfjJ 

[LOCATION]    rFIRSTFrr 
\TOPDO\V 


'.} 


ICOUNTER  TIMER  seconds] 

ownkr/dlx  n 

\pLi  ;j 


where 
STATE 

Loading  options: 

ALL 


DEAD  TIMER 

milliseiond.s 

DELAY  TIMER 

milliseconds 


(Invalid  for  VNP)  Sets  the  operational  state  for  all  PSI 
lines  to  either  OFF  or  ON. 


Loads  the  lines  with  all  of  the  default  parameters  speci- 
fied in  the  permanent  data  base.  If  you  specify  ALL,  you 
cannot  include  any  other  parameters. 

(For  DDCMP  CONTROL  lines  only)  Specifies  the  polling 
interval  for  a  dead  tributary. 

(For  DDCMP  CONTROL  lines  onlv)  Specifies  the  mini- 
mum time  to  delay  between  polls  in  order  to  limit  the 
effect  of  a  fast  control  station  on  a  slow  tributary. 
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o 


DUPLEX 
LOCATION 


Loaded  options: 

COrXTER 
TIMER  seconds 

OWXER 


Example: 


(Xot  applicable  tor  PSI  or  Ethernet  lines)  Sets  the  hard- 
ware transmission  mode  to  full  duplex  or  halt  duplex. 

Specifies  the  type  of  dynamic  memory  allocation. 

FIRSTFIT  (Delault)  Loads  the  driver  processes  at  the 
first  available  space  that  is  large  enough  in 
the  partition. 

TOPDOVVX  (Invalid  for  VXP)  Loads  the  driver  pro- 
cesses at  the  top  of  the  partition. 


(Invalid  for  \"SP)  Sets  a  timer  whose  expiration  causes  a 
PSI  line  counter  logging  event. 

Specifies  line  ownership. 

DLX      DLX     (See     the     DECnct-RSX    I'ro^rammcr's 
Reference  Manual.) 

PLI        PSI  (Invalid  for  VXP) 


NCP  SET  KNOWN  LINES  DUPLE;.'  FULL 


This  command  sets  all  lines  known  to  the  system  to  full  duplex. 
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NCP/VNP 


SET  LINE 


Tse  the  \CV  SKT  IJNK  command  either  to  load  the  specified  line  and  create 
its  associated  parameters  in  the  volatile  data  base  or  to  create  or  modity 
parameters  in  the  data  base  for  a  line  that  is  already  loaded.  Tse  the  VNP 
command  to  do  the  same  with  the  system  image  file. 

Restriction: 

F.xcept  for  STATK.  the  options  allowed  when  you  are  loading  a  line  are 
different  from  those  used  to  create  or  modity  parameters  tor  a  line  that  is 
already  loaded.  Any  line  that  you  are  loading  must  be  in  the  (M.EARKI)  state. 
A  line  that  is  already  loaded  must  be  in  the  ON  or  OPT  state  (that  is  not 
(^LKAHKD). 


Format: 

SKT  LINE  linr-id 

Loading  options: 


I^)aded  options: 


STATE  rOFF\l 

[ALLl 

1[CX)\TR()LI.ER!  (\SH  csr-address] 

[DEAD  TIMER  milliseconds] 

DELAY  TIMER  millisearnds] 

DIFLEX    rFlLl/X] 

\half/j 

ILOCATIOM    TfIRSTFIT   "ll 

Vropi)()vv\/J 

iMlLTIPOIXT  DEAD  dead-ratio] 
[PRIORITY  harduarr-prioritx] 
[I  SIT  (\SR  csr-addrcss] 
[VECTOR  Lector-address] 


COM  ROLLER  /LOOPBAC 
\N()RMAI 
pOUNTER  TIMER  seconds] 

OW.\ERp)LXY] 

Ipu  /J 


™}] 


where 
LLNt]  line- id 

STATE 


Specifies  the  line  to  be  loaded  and  lor  which  parameters 
are  to  be  created  or  modified. 


(Invalid  for  VNP)  Sets  a  PSI  line's  operational  state  t 
OFF  or  OX. 


o 
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Loading  options: 

ALL 


• 


CONTHOLLKIi 
(\SH  csr-address 

DKADTIMKR 

nullisi'conds 

DKLAV  TLMKH 

milliseconds 

nrPLKx 

LOCATION 


Ml'LTIPOINT 
DKAD 

dead -ratio 

PRIORITY 

harduarc-priority 

rxrr  csr 

csr-addre.ss 


Loads  the  Kne  with  all  of  tlu>  det'auh  parameters  specified 
in  the  permanent  data  base.  If  you  specity  ALL.  you  can- 
not include  any  other  parameters. 

Specifies  the  addre.ss  of  the  first  CSR  for  the  line  control- 
ler. 

(For  DDCMP  (X)NTROL  lines  only)  Specifies  the  polling 
interval  tor  a  dead  tributary. 

(For  I)I)(\MP  (M)NTROL  lines  only)  Specifies  the  mini- 
mum time  to  delay  between  polls  in  order  to  limit  the 
effect  of  a  fast  control  station  on  a  slow  tributary. 

(Not  applicable  for  PSI  or  Kthernet  lines)  Sets  the  hard- 
ware transmission  nu)de  to  full  duplex  or  half  duplex. 

Specifies  the  type  of  dynamic  memory  allocation. 

FIRSTFIT  (Default)  Loads  the  driver  proce.ss  at  the 
first  available  space  that  is  large  enough  in 
the  partition. 

TOPDOWN  (Invalid  for  VNP)  Loads  the  driver  process 
at  the  top  of  the  partition. 

Specifies  the  polling  rate  tor  a  tributary  in  the  dead  multi- 
point state  (range:  1  to  25')). 


Specifies  the  hardware  priority  of  the  controller  (range:  4 
to  7). 

Specifies  the  address  of  the  first  (\SR  tor  a  DEC'net  device 
controlled  by  a  KM(^   11. 

NOTE 

With  the  KDP.  a  unit  CSR  can  be  specified 
for  any  unit  on  the  controller. 

With  the  KDZ.  a  unit  (\SR  can  be  specified 
only  for  the  first  unit  set  in  the  associated 
DZ  multiplex  group. 


\t:ctor 

ievtor-address 


Specifies  the  vector  address  of  the  line  controller.  You 
mu;^t  use  the  vector  address  selected  on  the  device  or  0  if 
the  address  is  unknown  (range:  0  to  774  octal). 
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Loaded  options: 

CON'rHOLLKH 


roiNTKR 
TIMKH.sr(7,f2(y,s 

OWNER 


(For  Kthernet,  DMC  DMR.  DMI',  and  DMV  lines;  in- 
valid tor  \'\P)  Spt'iitifs  the  controller  mode  tor  the  line. 
The  line's  cireuit  must  be  in  the  OFF  state. 

LOOI^HACK      Internal  device  loophack  mode 

NORMAL  Normal  operating  mode 

(Invalid  for  \'NP)  Sets  a  timer  whose  expiration  causes  a 
FSI  line  counter  lo^gin^j  event. 

Specifies  line  ownership. 

IM.X      I)L\     I  See     the     DEC'rwt-RSX     Pro^ramnur's 
RefcrcrKr  Manual.) 

VIA        VS\  (Invalid  tor  VNP) 


Example: 


NCP-6ET    LINE 


OWNER    XPT 


This  command  .•^els  the  owner  ot  line  DMC  o  as  XFT.  which  assigns  the  line 
for  DKCnet  operations  onlv. 


• 
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NCP/VNP 


SET  LOGGING 


Use  the  NCP  SET  LOGGING  command  to  create  or  modify  logging  parame- 
ters in  the  volatile  data  base.  Use  the  VNP  command  to  do  the  same  with  the 
system  image  file. 

Restriction: 

Whenever  a  circuit,  line,  module,  node,  or  sink  is  specified  in  a  SET  LOG- 
GING command,  an  event  list  or  KNOWN  EVENTS  parameter  must  also  be 
included. 


• 


SET 


c 


• 


Format: 

I^KNOWN  lo(;gin(;  ^ 
LOGGING  CONSOLE  I 
LOGGING  FILE 
LOGGING  MONITOR 


where 

KNOWN 
LOGGING 

LOGGING 
CONSOLE 

LOGGING  FILE 


LOGGING 
MONITOR 

NAME  name 


NAME  name 
STATE  /OFF\ 

\0N  ; 

EVENTS  list 
KNOWN  EVENTS 


CIRCUIT  circuit-id 
LINE  line -id 
^  MODUT.E  rX25-PROTOCOL'J 
i  X26-SERVER       > 
l,X29-SERVER 
^NODE  node-id 
SINK    TeXECUTOR 

J  NODE   r node-id  \ 

\mosTj 


I 


STATE 


EVENTS  list 


Indicates  that  the  specified  parameters  are  to  be  created 
or  modified  for  all  known  logging  components. 

Indicates  that  the  specified  parameters  are  to  be  created 
or  modified  for  the  logging  console  only. 

Indicates  that  the  specified  parameters  are  to  be  created 
or  modified  for  the  logging  file  only. 

Indicates  that  the  specified  parameters  are  to  be  created 
or  modified  for  the  logging  monitor  program  only. 

Specifies  the  name  of  the  console  (default:  COO:).  file 
(default:  LB:[1.6]EVENTL0G.SYS).  or  monitc/r  program 
(default:  MON...)  to  which  events  are  to  be  logged. 

Sets  the  operational  state  of  the  logging  component  on 
the  executor  node.  When  the  state  is  OFF.  events  are 
discarded. 

Specifies  the  event  class  and  type(s)  to  be  logged.  See 
Chapter  2  for  the  event  list  format. 


~nN 
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En 


KNOWN 
EVENTS 

CIRCUIT 

circuit-id 

LINE  line-id 
MODULE 
NODE  node-id 
SINK 


Specifies  that  ail  events  that  DECnet  RSX  can  generate 
are  to  be  logged. 

(Invalid  for  VNP)  I^)gs  the  specified  event(s)  occurring  on 
the  specified  circuit  (see  restriction). 

Logs  the  specified  event(s)  occurring  on  the  specified  line 
(see  restriction). 

(Invalid  for  VNP)  Logs  the  specified  event(s)  occurring  on 
the  specified  module  (see  restriction). 

Ix)gs  the  specified  event(s)  occurring  on  the  spe'rified 
node  (see  restriction). 

Identifies  the  node  where  the  specified  event(s)  are  to  be 
logged  (see  restriction). 

EXECUTOR        (Default)  Executor  node 

NODE  node-id     The  specified  remote  node 

NODE  $HOST     (Invalid  for  NCP)  Host  node 


Examples: 

NCP>SET  KNOWN  LOGGING  KNOWN  EVENTS  CIRCUIT  DMC-0  SINK  NODE  BOS- 

1  ON 

This  command  dictates  that  known  events  on  circuit  DMC-O  be  sent  to  node 
BOSTON. 

NCP>5ET  LOGGING  CONSOLE  EVENT  2.1  SINK  NODE  ATL 

This  command  dictates  that  any  occurrence  of  event  2.1  be  logged  on  the 
console  at  node  ATL. 
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NCP 


SET  MODULE 
X25~ACCESS 


• 


Use  the  SET  MODULE  X25-ACCESS  command  to  specify  a  destination 
name  for  a  remote  DTE  in  the  volatile  data  base. 

Format: 


S  BESTINATrON  dest-name  NUMBER  dte-address  (iSCOPEl  scope] 


where 


DESTINATION 

dest-name 

NUMBER 

dte-address 


Specifies  a  destination  name  for  the  identified  remote 
DTE  address. 

Specifies  the  remote  DTE  address  to  be  associated  with 
the  specified  destination  name. 


SCOPE  scope  See  definition  in  Section  6.5.2. 

Example: 


NCP>5ET    (MODULE    ;;25-ACCESS    DE 
NCP>3CrjPE    TERMINAL     TT51: 


ST  I  NAT  I  ON    RDG7Z4    NUMBER    ^  1  1 '.'G  ^''/'OZO 


'J     -     RET 


This  command  (shown  in  continuation  format)  sets  a  destination  name  of 
RDG724  for  terminal  TT51:  at  DTE  address  411067002C)(). 
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NCP 


SET  MODULE 
X25-PROTOCOL 


Use  the  SET  MODULE  X25-PROTOCOL  command  to  create  or  modify  DTE 
or  group  parameters  in  the  volatile  data  base. 


Format: 


SST  litH^^EHiB  X2&-^PBCm)C0^ 


COUNTER  'TiMEMjeconthl 

State  (Wf  \^ 
ion    > 


\mmmimm^  J      [number ^mp-mmberj 


(TVPE  BILAHSRAy 


] 


where 


DTE-related  parameters: 


DTE 

dte-address 


Sets  parameters  for  the  specified  local  DTE  only.  See 
RSX-11  PSI  Network-specific  Information  for  the  address 
format  on  vour  network. 


KNOWN  DTES      Sets  parameters  for  all  local  DTEs. 


COUNTER 
TIMER  seconds 

STATE 


Sets  a  timer  whose  expiration  causes  a  DTE  counter  log- 
ging event. 

Sets  the  local  DTE's  operational  state. 

OFF         Not  available. 

ON  Available  for  normal  use. 

SHUT  Not  available  for  new  virtual  circuit  connec- 
tions; turns  off  when  the  last  virtual  circuit 
disconnects. 


Group-related  parameters: 

GROUP 

group-name 


KNOWN 
GROUPS 

DTE 

dte-address 


Sets  parameters  for  the  specified  group  only. 
Sets  parameters  for  all  known  groups. 


Specifies  the  local  DTE  associated  with  the  specified 
group.  This  parameter  must  be  used  with  a  group  number. 
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• 


NUMBER 

group-number 


TYPE 
BILATERAL 


Specifies  a  2-digit  closed  user  group  (CUG)  number  or  a  4- 
digit  bilateral  closed  user  group  (BCUG)  number  (range:  0 
to  9999;  you  can  omit  leading  zeroes).  This  parameter 
must  be  used  with  a  DTE  address. 

Required  when  the  specified  group  is  bilateral  (BCUG). 


Example: 

NCP^SET  MODULE  ;;25  -  PTyOTOCOL  GROUP  CUQZHl    NUMBETv  95  DTE  lG17555<a23G 


This  command  assigns  group  number  95  to  closed  user  group  CUG247  on  DTE 
16175554236. 
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NCP/VNP 


NCP 


SET  MODULE 
X25-SERVER 


SET  MODULE 
X29-SERVER 


Use  the  NCP  SET  M0DI;LE  X2.VX29-SERVER  commands  to  create  or 
modify  server  module  parameters  in  the  volatile  data  base.  Use  the  VNP  SET 
MODULE  X25-SERVER  command  to  change  the  server  module  state  in  the 
system  image  file.  (There  is  no  VNP  SET  MODULE  X29  SERVER  com- 
mand.) 

Restrictions: 

•  The  STATE  parameter  is  valid  only  for  SET  MODULE  X2r)- SERVER 
commands.  It  is  the  only  valid  parameter  for  VNP. 

•  You  cannot  modify  parameters  for  existing  destinations.  You  can  only  cre- 
ate new  destinations.  P^xisting  destinations  can  be  cleared,  then  reset  with 
new  parameters.  If  you  specify  a  destination  name,  you  must  also  specify 
the  object. 

•  If  you  specify  CALL  MASK  or  CALL  VALUE,  you  must  specify  both,  and 
the  hex-value  of  each  must  contain  the  same  number  of  digits. 


Format: 

SET  MODULE  /X25-SERVER\ 
1  X29-SERVER  f 


COUNTER  TIMER  seconds] 

"State  ("off  ^1 
{shut  J  ^ 

^     DEJUNATION  dest-name    OBJECT  object-id 

[CALL  MASK  hex-value  | 
[CALL  VALUE  hex-value] 
[GROUP  group-name] 
[NUMBER  dte-address] 
[PT^IORTTY  priority] 
[SUBADDRESSES  range] 


where 


COUNTER  TIMER 

seconds 

STATE 


Sets  a  timer  whose  expiration  causes  a  server  module 
counter  logging  event. 

(Valid  only  for  X25-SERVER  commands)  Sets  the 
module's  operational  state. 

OPE       Not  available. 

ON         Available  for  normal  use. 

SHUT    (Invalid  for  VNP)  Not  available  ior  new  vir 
tual  circuit  connections;  turns  oft  when  the 
last  virtual  circuit  disconnects. 


6-94       DECnet-RSX  System  Manager's.  Guide 


DKSTINATION 

drst-nnmc 

OBJECT 

object -id 


CALL  MASK 

hex-raluv 


CALL  VALl'K 

hrx-ialuc 


(;r()up 

^roup-name 

NUMBKH 

dte-address 

PRioHrrv 

priority 


SrHADDRESSFS 
ran^e 


Specifies  the  destination  for  which  server  parameters 
are  to  be  created. 

Specifies  the  task  that  runs  when  an  incoming  call 
activates  it.  Use  either  an  object  name  or  an  object 
type  code  to  identify  the  task  (see  Api)endix  B). 

Specifies  the  mask  applied  to  incoming  call  data  be- 
fore it  is  tested  against  the  call  value  (default:  no 
mask).  Cse  a  hexadecimal  string  of  2  to  .'{2  digits 
(must  be  an  even  number  of  digits);  see  restrictions. 

Specifies  a  string  of  informat.-u  u.sed  to  test  incoming 
call  data  (default:  no  test  strmgi.  I'se  a  hexadecimal 
string  of  2  to  :V2  digits  (must  be  an  even  number  of 
digits);  see  restrictions. 

Specifies  the  name  of  a  closed  user  group  (Cr(i)  or  a 
bilateral  closed  user  grouj)  (HClXi)  (defaidt:  no 
group). 

Specifies  the  remote  DTE  that  originates  the  call  for 
the  specified  destination  (default:  no  DTE). 

Specifies  the  priority  of  the  destination.  This  is  used 
to  select  one  of  a  set  of  destinations  lor  which  the 
incoming  call  may  be  valid  (range:  0  to  25.").  where  2')ri 
is  the  highest  priority;  default:  128). 

Specifies  a  range  of  local  DTE  subaddresses  that  iden- 
tities the  destination  for  (he  incoming  call. 


Examples: 


• 


NCP>bET  nODULE  '25 -SEVi^JEf-    STATE  SMUT 

This  command  makes  the  module  unavailable  for  new  virtual  circuit  'onnec 
tions  and  turns  it  off  uh^'n  thp  \-a<t  virtual  circuit  disconnects. 

NCP  SET  MODULE  -Zg-SEPUErv  COUNTER  TJMEP  ■ 

This  command  sets  tb    module  counter  timer  to  ()()(). 


• 
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<!!!^ 


NCP/VNP 


SET  NODE  CIRCUIT 


Use  the  NCP  SET  NODE  CIRCUIT  command  to  associate  a  DECnet  circuit 
with  a  loop  node  name  in  the  volatile  data  base.  Use  the  \'NP  command  to  do 
the  same  with  the  system  image  file. 

Format: 

SET      NODE  ra)de-name      CIRCUIT  circuit-id 
where 

NODE  Specifies  the  loop  node  with  which  the  circuit  is  to  be  associ- 

node-name      ated. 


CIRCUIT 

circuit -id 

Example: 


Specifies  a  DECnet  circuit  to  be  used  for  all  traffic  to  the  speci 
fied  loop  node. 


NCP  SET  NODE  LAS'.'GS  CIRCUIT  DMP-n.2 

This    command   sets   node   LASVGS   as   the   loop   node   name   for   circuit 
DMP-0.2. 


• 
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NCP/VNP 


SET  NODE  NAME 


Use  the  NCP  SET  NODE  NAME  command  to  associate  a  node  name  with  a 
node  in  the  volatile  data  base.  Use  the  VNP  command  to  do  the  same  with  the 
system  image  file. 

Format: 

SET      NODE  node-id      NAME  node-name 
where 


NODE 

node-id 

NAME 

node-name 


Specifies  the  node  for  which  a  name  is  to  be  created  or  modi- 
fied. The  node-id  must  be  a  node  address  if  you  wish  to  assign  a 
name  to  an  unnamed  node. 

Specifies  a  node  name  to  be  associated  with  the  node-id. 


Example: 


ncp:>set  node   12  name  blake 


This  command  a.ssigns  the  name  BLAKE  to  node  12. 
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NCP/VNP 


SET  OBJECT 


Use  the  NCP  SET  OBJECT  command  to  create  or  modify  object  parameters 
in  the  volatile  data  base.  Use  the  VNP  command  to  do  the  same  with  the 
system  image  file. 


Format: 

SET  OBJECT  t\pc-codc 


fCOPIES  f  number  Y] 

L  \single/J 

[NAME  object-name] 
USER  /default  V] 

\login     JJ 
Verification  (  inspect 

OFF 
ON 


where 

OBJECT 

type -code 

copies 

number 


NAME 

object-name 

USER 


Specifies  the  object  for  which  parameters  are  to  be  cre- 
ated or  modified.  Use  an  object  type  code  from  Appendix 
B. 

Specifies  the  maximum  number  of  copies  of  a  task  that 
can  be  run  at  once  (range:  2  to  64).  Use  the  keyword 
SINGLE  (default)  if  the  task  is  not  multicopy. 

Specifies  a  name  to  be  associated  with  the  object.  Use  any 
valid  RSX  task  name.  If  the  task  is  multicopy,  the  name 
must  end  with  % 


Specifies  the  UIC  under  which  a  task  is  to  run  when  th^ 
object's  VERIFICATION  option  is  set  to  ON  or  IN- 
SPECT. 

DEFAULT  (Default)  The  task  runs  under  the  default 
UIC  under  which  it  was  built  or  installed. 

LOGIN  The  task  runs  under  the  log-in  UIC. 

VERIFICATION      Specifies  the  degree  of  access  to  the  controlled      ject. 

INSPECT  Allows  access  to  the  object  while  indicating 
to  it  whether  or  not  the  access  control  infor- 
mation is  valid. 


OFF 


ON 


(Default)  Allows  access  to  the  object  re- 
gardless of  the  validity  of  the  access  control 
information. 

Allows  access  to  the  object  only  for  inbound 
connections  with  valid  access  control  infor- 
mation. 
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Example: 


NCPSET  06JECT  19  USETy  LOGIN  '.'ER  I  F  I  CAT  I  ON  ON 


This  command  specifies  that  object  19  is  to  run  under  the  log-in  UIC  and  that 
access  is  to  be  allowed  onlv  with  valid  access  control  information. 
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NCP/VNP 


SET  PROCESS 


Use  the  NCP  SET  PROCESS  command  to  load  processes  and  to  modify 
process  parameters  in  the  volatile  data  base.  With  NCP,  a  network  process 
remains  in  memorv'  until  you  clear  the  system  or  the  process  (see  CLEAR 
SYSTEM  and  CLEAR  PROCESS)  or  until  you  reboot  the  system.  Use  the 
\'\P  SET  PROCESS  command  to  load  processes  and  to  modify  process 
parameters  in  the  system  image  file. 

Restrictions: 

•  If  you  reload  NVV  after  clearing  it,  you  must  also  issue  the  SET  MODULE 
X25-PROTOCOL  command  (first  with  STATE  OFF  and  then  with  STATE 
ON)  to  update  the  process  pointers  to  the  data  base. 

•  Data  space  is  allocated  within  the  process's  addressing  space  only. 


Format: 

SET  PROCESS  prnccss-namc 


[ALL] 


where 

PROCESS 

process-name 

ALL 


LOCATION 


ITlocation;  Tfirstfit  \1 
1_  \topdo\vnjJ 

iMAXIMUM  CONTROLLERS  cnunt] 
IMAXIMUM  LINES  count] 
[PARTITION  partition-name] 


Specifies  the  process  for  which  parameters  are  to  be  mod- 
ified. Use  a  process  name  from  the  table  in  Chapter  2. 

Loads  the  process  with  all  process  parameter  defaults 
specified  in  the  permanent  data  ba  e.  If  you  specify  ALL. 
you  cannot  include  any  other  parameters. 

Specifies  the  type  of  dynamic  memory  allocation  for  the 
driver  process. 

FIRSTFIT       (Default)  Loads  the  process  at  the  first 
available  space  that  is  large  enough 

TOPDOWN     Loads  the  process  at  the  top  of  the  parti- 
tion. 
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MAXIMUM 
CONTROLLERS 

count 

MAXIMUM 
LINES  (7)1/^?^ 

PARTITION 

partition-namv 


Specifies  the  maximum  number  oC  hardware  cont rollers 
(range:  1  to  f)4)  for  which  the  process  is  to  allocate  data 
space  (see  restrictions). 

Specifies  the  maximum  number  oi'  lines  (range:  1  to  ()4) 
for  which  the  process  is  to  allocate  data  space  (see  re- 
strictions). 

Specifies  the  partition  name.  Use  a  name  consisting  of  1 
to  (i  Radix-5()  characters. 


Example: 


NCP    -F"     PROCESS 


'-L'M    LINES    : 


• 


This  command  limits  process  DPV  to  the  control  of  two  lines. 
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NCP/VNP 


SET  SYSTEM 


I'se  the  \CV  or  \'\P  SF/F  S\'STK\i  command  to  load  the  rommunieations 
Kxeeutive  and  all  network  process,  line,  circuit,  module,  and  node  delaults 
that  were  set  in  the  permanent  data  base. 

Format: 

SKI'      SY.srKM      JOV] 
where 


roi' 


(Invalid  tor  \CV)  Specifies  that  the  system  he  loaded  at  the  top 
of  memorv. 
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NCP 


SET  TRACE 


Ihe  the  SET  TRACE  command  to  start  (or  stop)  tracing  the  specified  line(s). 
For  more  information  on  the  trace  interpreter  task,  see  Chapter  111 


Format: 


SET  TRACE  /UNE  line-id      \lBUPFER  SIZE  block-count]   fsTATE  /oFF 


\aCTIVE  uses)  {FILE  file] 


L  ION 


'}] 


where 


LINE  line-id 
ACTIVE  LINES 

BUFFER  SIZE 

block-count 

FILE  file 

STATE 
Examples: 


Sets  tracing  for  the  specified  line  only. 

Sets  tracing  for  all  active  lines. 

Specifies  the  size  (in  32-word  blocks)  of  the  trace  buffer 
used  to  collect  trace  data  (range:  1  to  255;  default:  4). 

Specifies  the  name  of  the  file  to  which  trace  data  is  to  be 
copied  (default:  LB:[1,6]PSITRACE.SYS). 

Sets  the  TRACE  operational  state  to  OFF  or  ON. 


NCP  SET  TRACE  LINE  DMC-0  STATE  ON  BUFFER  SIZE  10 

This  command  turns  tracing  on  for  line  DMC-0  and  allocates  a  lO-block 
buffer  in  which  to  collect  trace  data. 

NCP  SET  TfyACE  ACTIVE  LINES  STATE  OFF 


This  command  turns  tracing  off  for  all  active  lines. 
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NCP/VNP 


NP 


SHOW  ALIAS 


Tse  the  NCF'  SHOW  ALIAS  command  to  display  alias  information  stored  in 
the  volatile  data  base  (see  Chapter  .'^).  I'se  the  VNP  command  to  do  the  same 
with  the  system  image  tile. 


Format: 

SHOW  Call  aliasks 

ALIAS  alias-name 
KNOWN  ALIASKS 

where 

ALL  ALIASE: 

ALIAS 

alias-name 

KNOWN  ALIASES 


CHARACTERISTICS 
Sl'MMARY 


"/(CHARACTERISTICS^ 
I^SCMMARY  J 


SCOPE  scope 


TO  ///(' 
Example: 


[[SCOPE;    scope]     [TO  file] 


Displays  information  for  all  aliases. 

Displays  information  for  the  specified  alias  only. 

Displays  information  for  all  aliases  for  the  specified 
scope  (default  scope  is  your  terminal). 

See  definitions  in  Section  6.5.2. 

(Invalid  for  ALL  ALIASES)  See  definition  in  Sec- 
tion 6.5.2. 

(Valid  for  NCP  onlv)  See  definition  in  Section  6.5.2. 


NCP  -BHOW  ALIAS  SMITH  CH  AR  AC  TETv  I  ST  I  CS  TErfMINAL  TT2a:  -  REf 
NCP  TO  LB: C  1  .9]AL IAS. SYS 

This  command  (shown  in  continuation  format)  directs  static  display  informa- 
tion for  alias  SMITH  on  terminal  TT24:  to  file  LB:[1,91ALIAS.SYS. 
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NCP/VNP 


SHOW  CIRCUIT 


NP 


I'se  the  \CP  SHOW  CIRCl'IT  command  to  display  circuit  information 
stored  in  the  volatile  data  base  (see  Chapter  'A).  I'se  the  VNF  command  to  do 
the  same  with  the  system  image  tile. 


Format: 

ACTivK  riRrriTs 


^ KNOWN  riRcriTs        r 

[siCNIFirANT  riR(  riTS 


CHARACTERISTICS 
COCNTKRS 
STATCS 
SCMMARY 


[TO  filv 


where 

CIRCriT 

circuit -id 

ACTIVE 
CIRCriTS 


Displays  information  Cor  the  specified  circuit  only. 

(Invalid  for  VNP)  Displays  information  for  all  active 

circuits. 


KNOWN  CIRCUITS       Displays  informaticm  for  all  known  circuit; 


SIGNIFICANT 
(TRCCITS 

CHARACTERISTICS 
COUNTERS 
STATIS 
SUMMARY 


(Invalid  for  VNP)   Displays  information  about   all 
circuits  for  which  information  is  available. 

See  definitions  in  Section  8..'). 2. 


TO  file 
Example: 


(Valid  for  NCP  onlv)  See  definition  in  Section  6.5.2. 


NCP    SHOW    ACTIVE    CITyCUlTS    COUNTETyS 


This  command  displays  circuit  error  and  performance  statistics  for  all  active 
circuits. 
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NCP/VNP 


NP 


SHOW  EXECUTOR 


Use  the  NCP  SHOW  EXECITOR  command  to  display  local  node  informa- 
tion stored  in  the  volatile  data  base  (see  Chapter  3).  I'se  the  VNP  command 
to  do  the  same  with  the  system  image  file. 


Format: 

SHOW  EXECITOR 


where 

CHARACTERISTICS 
COUNTERS 
STATUS 
SUMMARY 

TO  file 


CHARACTERISTICS  ]  [TO  file 

COUNTERS 

STATUS 

SUMMARY 


See  definitions  in  Section  6.n.2. 


(Valid  for  NCP  onlv)  See  definition  in  Section  6.5.2. 


Example: 


NCP  SHOW  E;;ECUTory  status 


This  command  displays  local  node  dynamic  information. 
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NCP/VNP 


NP 


SHOW  LINE 


I'se  the  \rP  SHOW  LINK  command  to  display  line  int'orniation  stored  in  the 
volatile  data  hase  (see  Chapter  'A).  I'se  the  VXP  command  to  do  the  same 
with  the  system  ima^e  tile. 


F    .nat: 


SHOW  f'^X^'  linr-td 

J  A(T1VK  LINKS 


l: 


known  links 
si(;nifi(\ant  links, 


CHAHACTKHISriCS 

(X)rN'rKHs 

STATIS 
SIMMARV 


[TO  fil, 


where 


LINK  linr-id 
ACTIVK  LINKS 

KNOWN  LINKS 

SIONIFICANT 
LINKS 

CHAHACTKRISTICS 
rOlNTKHS 
ST  ATI'S 
Sl'MMARV 


Displays  information  for  the  specified  line  only. 

(Invalid  for  VNP)  Displays  information  for  all  active 
lines. 

Displays  information  for  all  known  lines. 

(Invalid   tor  \'N'P)   Displays  information  about   all 
lines  for  which  information  is  available. 

See  definitions  in  Section  (>."). "J. 


TO  file 
Example: 


(N'alid  for  NCP  onlv)  See  definition  in  Section  (v").!^. 


NCP     SHOW     LINE     DMC-1     SUM^IARV     TH     L  P  :  T  I    .  •"  ]  L  I  Ni  r  L  ^^  .  .,     .. 

This  command  directs  the  most  useful  information  about  line  DMC    I  to  a  file 
named  LB:;i.(i;LINSrM.SVS. 
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NCP/VNP 


SHOW  LOGGING 


NP 


I'se  the  \CV  SHOW  I.OCiCiINCi  command  to  display  lo^^inj:  information 
stored  in  the  vohitile  data  hase  (see  Chapter  Ml.  Ise  the  VNP  command  to  do 
the  same  with  the  system  imaj;e  I'ile. 


SHOW 


Format: 

ACTIVK  LCH.CINd 
KNOWN  LOOC.INC 
LOOCINc;  CONSOLK 
LOOCINO  FILK 

LO(;(;iN(;  moniiok 

SIC.NIKICANT  I.()(;(;iN(; 


CHAHACrKKIS'lK'S 
KVFATS 
SIATIS 
SCMMARY 


;'l"()  fllr 


K KNOWN  SINKS        Y\ 
SINK  NODK  nndi-idjj 


where 

ACTIVK  L()(;(;iN(; 

KNOWN  LOCIC.INC, 

I.OC.C.INC, 
(^ONSOLK 


(Invalid  lor  \'NI'i  Displays  all  active  Ioi:^Mn^  infor- 
mation. 

Displays  information  tor  all  known  log^in^  compo- 
nents. 

Displays  information  for  the  log^in^  console  only. 


LOCidINd  KILK  I)ispla>s  information  for  the  lo^jiin^'  file  only. 


LOC.C.INC, 
MONITOR 

SJC.NIFICANT 
L()(;C,IN(; 

CHAHACTKHIS'lICS 

siArrs 

Sr  MM  AKV 
KVKN'rs 

TO  file 
KNOWN  SINKS 

SINK  NODK 
node-id 


Displays  information  for  the  lo^'^'in^  monitor  pro- 
gram only. 

(Invalid  for  \'NIM  Display^  logKin^'  information 
ahoiit  all  sink  typt*>  for  which  infurmalion  is  avail- 
able. 

See  definitions  in  Section  (i.o.^. 


Displays  event   class  and  type  information  for  the 
given  logging  component. 

(Valid  for  NCI*  only  I  See  definition  in  Section  (i."). 2. 

(Default  I  Displavs  logging  information  for  all  known 
sink  nodes. 

Display:'  louging  informafion  for  tfic  >p('cified  sjnk 
nodt'  onlv. 
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Example: 


NCP    "-^'^    LOGGING    PILE    EVEr^ 


This  c-(>nii7iand  displavs  event  ilass  and  tvpc  iiilortnalioii  tor  the  lo^'^'in^'  tile 
on  node  ('Hl4i: 


• 
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NCP/VNP 


SHOW  MODULE 
X25-ACCESS 


HP 


Use  the  NCP  SHOW  MODULE  X25-ArCESS  command  to  display  remote 
DTE  destination  information  stored  in  the  volatile  data  base  (see  (^hapter  3). 
I'se  the  VNF  command  to  do  the  same  with  the  system  image  file. 


Format: 

SHOW  MODULE  X25-ACCESS     TaLL  DESTINATIONS        ^ 

J  DESTINATION  de«t-name   f 

|known  destinationsJ 

KSCOPEl  scope]  (TO  file] 

where 


K  CHARACTERISTICS  Yl 
SUMMARY  Jj 


ALL 
DESTIXATIOXS 

DESriNATION 

dcst-namc 

KNOWN 
DESTINATIONS 

(CHARACTERISTICS 
SIMMARY 

SCOPE  scope 

TO  file 

Example: 

NCP    SHOW    nODULE       25 


Displays  information  for  all  destinations,  regardless 
ol  scope. 

Displays  inlormation  for  the  specified  destination 
only. 

Displays    information    for    all    known    destinations 
within  tl     specified  scope. 

See  definitions  in  Section  (i.n.'i. 


See  definition  in  Section  6.5.2. 

( VaJid  for  NCP  only)  See  definition  in  Section  6.5.2. 

hCCESS  all  destinations  CHARACTEfvIST  ICS 


This  command  displays  static  information  for  all  destinations. 


6-110       DECnet-RSX  System  Manager's  Guide 


NCP/VNP 


SHOW  MODULE 
X25-PROTOCOL 


NP 


I'se  the  NTP  SHOW  MODl'LE  X25  PROTOCOL  command  to  dis-lay  pro- 
tocol module  information  stored  in  the  volatile  data  base  (see  Chapter  3).  I'se 
the  VNF  command  to  do  the  same  with  the  system  im.ai,'e  tile.  Some  types  of 
information  can  be  qualitied  by  either  DTK  or  ^roup 


Format: 

SHOW  MODULE  X25-PROTOCOL  f/DTE  die  address'^         ffCHARACTERISTICsT 

1  KNOWN  DTES  J  J  COUNTERS  f 

^  -"         n  SUMMARY  J 

IYgROUP  group-nameW    f/cF  *  RACTERISTICS  \ 
jj^KNOWN  GROUPS  Jj   hsUMMARY 

ITcHARACTERiSTICsTl      (TO  file] 
N  STATUS  f 

[JSUMNARY  JJ 


/ 


(TO  file] 


rrO  file] 


where 

DTE 

dtr-ndcin'.'>.s 

KNOWN  DTES 

(iROrP 

iiroup-namc 

KNOWN  (iROrPS 

CHARACTERISTICS 
COCNTERS 
STATl  S 
SIMMARY 


Displays  information  for  the  specified  DTE  only. 

Displays  information  lor  all  known  DTEs. 
Displays  information  for  the  specified  ^roup  only 

Displays  information  for  all  known  groups. 
See  definitions  in  Section  6.5.2. 


IX)  //7c 
Example: 


(Valid  for  NCPonlv)  See  definition  in  Section  6.5.2. 


NCP    SHOW    f^QDULE     ;;25  -  PryOTQCOL     KNOWN    GTvOUPS    SUMMhR  ,' 

This  command  displays  the  mr)st  useful  information  about  all  known  groups 
in  the  network. 
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NCPA^NP 


SHOW  MODULE 
X25-SERVER 

SHOW  MODULE 
X29-SERVER 


I'se  the  \CF  SHOW  MODILK  X'2.VX29  SP:RVER  commands  to  display 
server  module  information  stored  in  the  volatile  data  base  (see  Chapter  :]). 
I'se  the  \'N}*  commands  to  do  the  same  with  the  system  ima^'e  file.  Some 
ty|)es  ot  information  can  be  qualified  by  destination. 

Format: 

SHOW    MODULE /X25-SERVER\rrDESTINATION    dest-nameT\  f/'CHARACTERISTICS'l]  (TO  file] 

\X29-SERVER  J  OLKNOWN  DESTINATIONS  /J  LlsUMMARY  /J 


CHARACTERISTICS 
COUNTERS 
STATUS 
SUMMARY 


y^ 


(TO  file] 


where 

DKSTINATION 

dcst-nanw 

KNOWN 
DKSTINATIONS 

rHARA(^TERISTI(\S 

rorNTKRs 

STATUS 
SIMMARY 

TO  //■/(' 
Examples: 


Displays   information  tor  the  specified  destination 
only. 

Displays  information  for  all  known  destinations. 


See  definitions  in  Section  <!."), 2. 


(\'alid  for  NCR  onlv)  See  definition  in  Section  6.0.2. 


NCP  SHOW  MODUl ■ 


5-SERVEry  COUNTERS  TO  LB  :  [  1  .G  ] ;; Z5CTR  .  SYS 


This  command  directs  the  error  and  performance  statistics  for  the  module  to  a 
file  named  I.B:;i,6:X25rTR.SYS. 


NCP  SHOW  KODUL 


"EryJETr  DESTINATION  CH155  CHARACTETv  I  ST  I  C5 


This  command  displays  static  module  information  for  destination  CHIoo. 
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NCP/VNP 


NP 


SHOW  NODE 


I'se  the  NCF  SHOW  NODE  command  to  display  node  information  stored  in 
the  volatile  data  base  (see  Chapter :]).  I'se  the  V\P  command  to  do  the  same 
with  the  system  ima^e  file.  See  the  SHOW  EXECITOR  command  for  execu- 
tor node  displays. 

Restriction: 

No  information  will  be  displayed  for  an  end  node  until  a  link  has  been  estab- 
lished to  it.  The  node  may  appear  to  be  unreachable  even  when  it  is  not. 


Format: 

SHOW 


NODE  nndc-id 

active  nodes 
ai).ia(;ent  nodes 
known  nodes 
loop  nodes 
significant  nodes 


rHARACTEHIS 
COINTEHS 


S  STATIS 
I^SIMMAKV 


srirsT 


-y^ 


TO  file] 


where 


NODE  w^dv-id 
ACTIVE  NODES 


ADJACENT  NODES 

KNOWN  NODES 

LOOP  NODES 

SICtNIFICANT 
NODES 

CHARACTERISTICS 
COINTERS 
STATIS 
SCNLMARV 


TO/V/c 
Example: 


Displays  information  for  the  specified  node  only. 

(Invalid  for  VNP)  For  a  routing  node,  displays  infor- 
mation for  all  reachable  nodes.  For  a  nonrouting 
node,  displays  information  for  all  nodes  that  are  (1) 
adjacent.  (l2)  desi^mated  routers,  or  ['M  connected  to 
the  executor  by  a  logical  link. 

Displays  information  for  all  adjacent  nodes. 

Displays  information  for  all  known  nodes. 

Displays  inf(trmation  tor  all  loop  nodes. 

(Invalid  tor  VNR)  Displays  information  about  all 
nodes  for  which  any  information  is  available. 

See  definitions  in  Section  f).ri.2. 


(Valid  for  NCP  only)  See  definition  in  Section  B.'i.'J. 


NCP 


This  command  displays  error  and  performance  statistics  for  all  known  nodes. 


Network  Management  Utilities       6-113 


NCP/VNP 


HP 


SHOW  OBJECT 


I'se  the  NCP  SHOW  OB-IKCT  command  to  display  object  information  stored 
in  the  volatile  data  base  (see  Chapter  Ml.  Ise  the  VNP  command  to  do  the 
same  with  the  svstem  ima^ze  tile. 


Format: 

SHOW 


CoHAVrV  npr.vodr   \    [/(  HAKACTKHISTICS  ^"| 
\KN()\VN  ()K.1K("TS/    [\srMMAFn"  /J 


rro  //7c 


where 


OH.IKCT 

KNOWN  OH.IK(  TS 

CHAHACTKHISTICS 
SIMMAHV 

TO  fih' 
Example: 


NC^ 


Displays  information  lor  the  specified  object  only 
I'se  an  object  type  code  from  Appendix  B. 

Displavs  information  for  all  known  objects. 

See  definitions  in  Section  V^.'^:2. 

(\'ali(l  tor  NCI'onlvi  See  definition  in  Section  (v'). "J. 


This  command  displavs  only  the  most  useful  information  about  object  2">. 
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NCP/VNP 


SHOW  PROCESS 


HP 


Ise  the  Nt'P  SHOW  F*HO('KSS  command  to  display  process  information 
stored  in  the  volatile  data  base  (see  Chapter  Ml.  I'se  the  VNF'  command  to  do 
the  same  with  the  system  imajje  file. 


Format: 

SHOW    f  PROCKSS  pnnrss-nam, 
ACTIVK  PHOCKSSKS 
KNOWN  PKOCKSSKS 


KSTATIS      V]      TO/V/f 
SIMMAKV/J 


where 

PF^OOKSS 

prmrss-rntnu' 

ACTIVK 
FM^OCKSSKS 

KNOWN 
PROCKSSKS 

STATIS 
SIMMAHV 

TO  file 
Example: 


Displays  information  for  the  specified  process  only.  I'se  a 
process  name  from  the  table  in  Chapter  '2. 

(Invalid  tor  \'NF)  Displays  information  for  all  active  pro- 
cesses. 

Displays  information  for  all  known  processes. 


See  definitions  ni  Section  <i.ri.2. 


<\'alid  for  NOP  onlyi  See  definition  in  Section  (i.r).2. 


NCP 


This  command  displays  dynamic  information  for  process  KDP. 
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NCP/VNP 


SHOW  SYSTEM 


NP 


I'se  the  NTP  SHOW  S^'STKM  lommand  to  display  systrni  information 
stored  in  the  volatile  data  base  (see  Chapter  .^i.  I  se  the  \"NP  coniniand  to  do 
the  same  with  the  system  image  tile. 


Format: 

SHOW  SVSTKM 


Y 


where 


(llAHAOTKHISTIOS 
rOl'NTKHS 
STATIS 
SIMMAHV 

T()/7/r 


('HARACTKKISIICS  ]  TO /»/«•! 

(•()r\rKR>. 

S  TA'n  S 

SIMMAHV 


See  dei'initions  in  Section  <i..").2. 


(  \alid  tor  N("l'  onlv)  See  detiinl  ion  in  Section  ♦i.o  'J. 


Example: 


NCP  5H0W  SYSTEM  COUNTERS 


This  command  displays  system  error  and  performance  statistics. 
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NCP 


HP 


SHOW  TRACE 


Use  the  SHOW  TRACE  command  to  display  trace  information  stored  in  the 
volatile  data  base  (see  Chapters  3  and  13). 

Format: 

SHOW  TRACE      ITSTATUS      Y)       JTO  file] 

llSUMMARYjrj 

where 

STATUS  See  definitions  in  Section  6.5  2. 

SUMMARY 


TO  file 
Example: 


See  definition  in  Section  6.5.2. 


• 


NCP-5H0W    irvACE     TQ    LB  :[  1  .  G  ]  TRACE  .  SYS 


This  command  directs  a  summary  (bv  default)  of  trace  information  to  file 
LB:[1.6]TRACE.SYS. 
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NCP 


NP 


TELL 


Use  the  TELL  prefix  to  send  an  NCP  command  to  a  remote  node  for  execu- 
tion. TELL  sets  the  executor  for  only  one  command  and  must  prefix  the 
command  for  which  it  is  intended.  The  TELL  part  of  the  command  always 
executes  at  the  local  node,  even  though  the  executor  may  he  set  to  a  remote 
node  identification.  You  can  specify  access  control  information  (if  required)  to 
connect  to  the  remote  node. 

Format: 

TELL  nodc-idlacc-con-info]  ncp-cammand 

where 

nodv-id  Specifies  the  node  (by  name,  alias,  or  address)  to  receive  and 

execute  the  NCP  command. 

acc-con-info         Specifies  access  control  information  (if  required)  to  connect 

to  the  node. 

ncp-command  Represents  any  valid  NCP  command  that  is  remotely  exe- 
cutable. Appendix  A  lists  all  NCP  commands  and  tlags 
those  that  are  not  executable  remotely. 

Example: 

NCP:TELL  bos  LOAD  NODE  ALB 

This  command  sends  the  LOAD  NODE  command  to  node  BOS,  where  it 
executes. 


• 
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NCP 
TRIGGER  NODE 


Use  the  TRIGGER  NODE  command  to  trigger  the  bootstrap  mechanism  of  a 
node  so  that  the  node  loads  itself.  This  command  initiates  the  loading  se- 
quence for  an  unattended  system.  For  information  on  down-line  load  opera- 
tions, see  Chapter  4. 


Format: 

TRKK^ER  NODE  nodr-id 


where 

NODE  nodv-id 
VIA  circuit -id 

PHYSICAL 
ADDRESS 

E- ad  dress 


[SERVICE] 
PASSWORD 

password 


[VIA  circuit -id] 

[PHYSICAL  ADDRESS  E-addrcss] 

[[SERVICE]  PASSWORD  password] 


Specifies  the  node  whose  bootstrap  is  to  be  triggered. 

Specifies  the  circuit  over  which  the  operation  is  to  take 
place. 

(For  Ethernet  nodes  only)  Identifies  the  Ethernet  physical 
address  that  the  node  currently  uses  to  identify  itselL  (Re- 
quired for  Ethernet  circuits  if  the  hardware  address  param- 
eter has  not  been  specified  in  the  volatile  data  base;  see 
SET  NODE.) 

Specifies  the  password  required  to  trigger  the  bootstrap 
mechanism  on  the  node. 


NOTE 

If  you  do  not  want  a  password  echoed  to  your 
terminal  while  you  enter  it.  press  the  RE- 
Tl'RN  key  after  the  keyword  PASSWORD. 
NCP  prompts  for  the  password  and  turns  off 
echoing  until  the  next  prompt. 


Examples: 


NCP.^rvIGGER    NODE    NVC 


This  command  triggers  the  bootstrap  mechanism  on  node  NYC  to  initiate  a 
down-line  load. 


NCP  ■THflGGErv    NODE    NYC    VIA    DhC-O    PASSWORD    5A 

This  command  provides  service  password  5A  to  trigger  the  1  ootstrap  mecha- 
nism on  node  NYC  and  initiate  a  down-line  load  over  circuit  DMC-0. 
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NCP 

TRIGGER  VIA 


Use  the  TRIGGER  VIA  command  to  trigger  the  bootstrap  mechanism  of  a 
node  so  that  the  node  loads  itself.  This  command  initiates  the  loading  se- 
quence for  an  unattended  system  by  triggering  the  node  via  the  specified 
circuit.  The  node  identification  is  obtained  from  the  volatile  data  base  on  the 
executor  node.  For  information  on  down-line  load  operations,  see  Chapter  4. 


Format: 

tri(;(;kr  via  cirvuit-id 


[PHYSICAL  ADDRESS  H-ncidn'ss] 
KSKRVIO::  PASSWORD  passunrd] 


where 

VIA 

'  ircuit-id 

PHYSICAL 
ADDRESS 

F.-addrcss 


[SERVICE] 
PASSWORD 

password 


Specifies  the  circuit  over  which  the  operation  is  to  take  place. 

(For  Ethernet  nodes  only)  Identifies  the  Ethernet  physical 
address  that  the  node  currently  uses  to  identify  itself.  (Re- 
quired for  F^thernet  circuits  if  the  hardware  address  parame- 
ter has  not  been  specified  in  the  volatile  data  base;  see  SET 
NODE.) 

Specifies  the  password  required  to  trigger  the  bootstrap 
mechanism  on  the  node. 

NOTE 

If  you  do  not  want  a  password  echoed  to  your 
terminal  while  you  enter  it.  press  the  RE- 
Tl'RX  key  after  the  keyword  PASSWORD. 
NCP  prompts  for  the  password  and  turns  oft 
echoing  until  the  next  prompt. 


Examples: 


NCP    TrylGGETy    '.' I  A    DMC-0 

This  command  triggers  the  bootstrap  mechanism  on  the  node  connected  to 
circuit  DMC-0. 

NCP  TRIGGETy  VIA  DMC-'.'  PASBWOrvD  FF 

This  command  provides  service  password  FF  to  trigger  the  bootstrap  mecha- 
nism on  the  node  connected  to  circuit  DMC-O. 
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NCP 
ZERO  CIRCUIT 


Tse  the  ZERO  CIRmT  command  to  zero  circuit  counters  for  the  specified 
circuit(s).  The  executor  node  maintains  these  c(>unters  on  a  {)er  circuit  basis. 


Format: 

ZF 


:KR0    (cmCVlT  circuit -id    \ 

)^KN()vvN  (MRcrrrs  J 


[COrXTERS! 


where 


CIRCriT        Zeroes  counters  for  the  specified  circuit  only 
circuit -id 

KNOWN         Zeroes  counters  for  all  known  circuits. 
CIRniTS 


Example: 


NCP  ZETvO  CIRCUIT  DMC-0 


This  command  zeroes  circuit  counters  for  circuit  DMC  0. 
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NCP 
ZERO  EXECUTOR 


Use  the  ZKRO  KXECITOR  command  to  zero  node  counters  associated  with 
and  maintained  on  the  executor  node. 

Format: 

ZKHO  KXKCnTOR  ;(X)rNTKHSl 
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NCP 
ZERO  LINE 


o 


• 


I  se  the  ZKRO  LINK  roniniand  t(t  zero  line  counters  tor  the  specitied  linelsl 
I'he  executor  node  maintains  these  counters  on  a  per  line  basis. 

Format: 

AKHO    flASK  Imr-id       \     iCOlNl'KKS 
"I^KNOWN  MNKSj 

where 

LINK  liru'-id  Zeroes  counters  tor  the  specified  line  only. 

KNOWN  LINKS      Zeroes  counters  tor  all  known  lines. 

Example: 

NCP   -■••:•  : 

This  commani  zeroes  line  counters  for  line  \)\'\'  :\. 
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NCP 

ZERO  MODULE 
X25-PROTOCOL 


I'se  the  ZERO  MODULE  X2o-PROTOCOL  command  to  zero  module  count- 
ers for  the  specified  DTE(s).  The  executor  node  maintains  these  counters  on  a 
per  DTE  basis. 

Format: 

ZERO  MODULE  X25-PROTOCOL  /dTE  dte-addres^A    [COUNTERSl 

IJKNOWN  DTES  J 

where 


DTE 

dtc-address 


Zeroes  counters  for  the  specified  DTE  only 
KNOWN  DTES      Zeroes  counters  for  all  known  DTEs. 


Example: 


NCP    ZERO    MODULE    );Z5  -  PryOTQCGL    DTE     123^58789 


This  command  zeroes  X.25  protocol  module  counters  for  DTE  123456789. 
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NCP 


ZERO  MODULE 
X25-SERVER 

ZERO  MODULE 
X29-SERVER 


Use  the  ZERO  MODULE  X2o/X29-SERVER  commands  to  zero  X.25/X.29 
server  module  counters  that  are  maintained  on  the  executor  node. 

Format: 

ZERO  MODULE  /X25-SERVER  \    ICOUNTERS] 

\X29-SERVER  / 
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NCP 
ZERO  NODE 


Use  the  ZERO  NODE  command  to  zero  node  counters  for  the  specified 
node(s).  The  executor  node  maintains  node  counters  on  a  per  node  basis. 

Format: 

ZERO   TnODE  node-id      \      [COUNTERS] 

\knownnodesj 

where 

NODE  node-id  Zeroes  counters  for  the  specified  node  only. 

KNOWN  NODES      Zeroes  counters  for  all  known  nodes. 

Example: 


• 


NCP  -ZEryO    NODE    ATL 


This  command  zeroes  node  counters  for  node  ATL. 
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NCP 


ZERO  SYSTEM 


Use  the  ZERO  SYSTEM  command  to  zero  system  counters  associated  with 
and  maintained  on  the  executor  node. 

Format: 

ZERO  SYSTEM  [COUNTERS] 
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6.5.4    RSX~11S  NCP  Command  Summary 

This  section  summarizes  the  NCP  and  NICE  commands  that  are  supported 
by  RSX-US.  This  is  a  subset  of  the  commands  supported  on  RSX  llM  and 
RSX-llM-PLl'S  operating  systems.  Tnless  otherwise  noted  in  the  restriction 
section  of  an  individual  command  description,  all  of  the  following  commands 
can  be  initiated  both  locally  (that  is.  at  the  RSX-  llS  node)  and  remotely  (not 
at  the  RSX-llS  m)de). 

The  commands  are  presented  in  alphabetical  order,  using  the  same  defini- 
tions described  in  Section  6.5.2.  To  distinguish  this  subset  from  the  full  set. 
NCP/S  is  printed  at  the  top  of  each  page  above  the  command  name.  In 
addition,  each  command  is  designated  as  privileged  (P)  or  nonprivileged 
(NP). 
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NCP/S 


LOOP  EXECUTOR/NODE 


HP 


Tse  the  LOOP  NODK  command  to  test  a  node  in  the  network,  ^'ou  can 
inc'hide  access  control  information  it  the  node  requires  it.  If  you  are  testing'  the 
executor  node,  you  can  use  the  I.OOI'  KXKCITOK  command.  Kither  com- 
mand causes  test  hlocks  ot  data  to  be  transmitted  to  the  specified  node.  See 
Chapter  'A  for  more  information  on  ioophack  testing. 


Format: 


.OOP  /NODK  nndv-idlacc-inn-infn\ 
\K\K("1T()H  / 


rnVW  n>unt] 
:LK\(.  FH  lrni:th 
WITH    rMIXKI) 
ONKS 
ZKHOKS. 


where 


ac(  -cnn-info 
KXKCITOR 

an'ST  count 


NODK  ni>dr-id     Specifies  a  node  for  Ioophack  testing. 

Specifies  access  lontrol  information,  if  reijuired. 

Specifies  the  executor  node  for  Ioophack  testing. 

Specifies  the  number  of  hlocks  to  be  sent  during  Ioophack 
testing  (range:  I  to  Cvv<.\'y,  default:  !  block  is  looped). 

Specifies  the  length  (in  bytes)  of  blocks  to  be  .sent  during 
Ioophack  testing.  When  testing  over  the  Kthernef.  the 
length  must  be  a  decimal  integer  in  the  range  of  :VJ  to  UMl. 
Otherwise,  the  length  must  he  a  decimal  integer  in  the 
range  of  1  to  n.  where  ^?  must  be  less  than  the  smaller  of 
either  the  local  looper  buffer  size  or  the  remote  mirror  buffer 
size  (default:  40  bytes). 

Specifies  the  type  of  binary  information  to  be  sent  during 
testing  (default:  MIXKI)  a  combination  of  ones  and 
zeroes). 


LFA'OTH 

If'fmth 


WVVH 


Example: 


NCP    LOOP    MCDE     N  'C     COUNT     \n 


This  command  loops  10  blocks  of  mixed  test  messages  to  remote  node  NN'C 
F^ach  block  is  40  bvtes. 
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NCP/S 


SET  CIRCUIT 


Tse  the  SET  (MRCIIT  command  to  set  the  operational  state  for  the  specil'ied 
circuit  in  the  volatile  data  base. 


Format: 

where 


STATK  /OFF^ 


riHCH'IT        Specifies  the  circuit  whose  state  is  to  be  set. 
circuit-id 

STATP".  Sets  the  circuit's  operational  state  to  ON  or  OFF. 

Example: 


NCP 


:  ■     •*  L  J     ;  ■  J    5  f  A  "^  F     ">  t-  r 


This  command  sets  the  state  of  circuit  KI)Z   1  M  to  OFF, 
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NCP/S 


SET  EXECUTOR  HOST 


Use  the  SET  EXECUTOR  HOST  command  to  specify  a  host  node  in  the 
volatile  data  base. 

Format: 

SET  EXECUTOR  HOST  nndr-addrrss 
where 


HOST 

nodc-addrpss 

Example: 


Specifies  the  address  for  the  host  node  to  be  used  for  down- 
line load,  trigger,  and  up-line  dump  service  operations. 


NCP>5E^     E     ECUTOR    HOST    08 


This  command  sets  node  08  as  host  node  for  down-line  load,  trigger,  and  up- 
line dump. 


Network  Management  Utilities       6-131 


NCP/S 
SET  LINE 


Use  the  SET  LINE  command  to  set  the  controller  mode  for  a  specified  loaded 
line  in  the  volatile  data  base. 

Restrictions: 

•  SET  LINE  cannot  be  initiated  from  a  remote  node. 

•  The  specified  line  must  be  in  the  ON  or  OFF  state  (that  is,  not  CLEARED). 


Format: 

SET  LINE  line-id  CONTROl 


.LER  /L00PBACK\ 
\N0RMAL     / 


where 
LINE  line- id 


CONTROLLER 


Specifies  the  line  for  which  the  controller  mode  is  to  be 
specified. 

(For  Ethernet,  DMC/DMR,  DMP,  and  DMV  lines)  Speci- 
fies the  controller  mode  for  the  line.  The  line's  circuit  must 
be  in  the  OFF  state. 

LOOPBACK      Internal  device  loopback  mode 
NORMAL  Normal  operating  mode 


Exampie: 


NCP;SET  LINE  DMC-0  CONTryOLLER  LOOPBACK 


This  command  sets  the  operating  mode  for  line  DMC-0  to  loopback  mode. 
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NCP/S 


SET  LOGGING 
CONSOLE 


Use  the  SET  LOGGING  CONSOLE  command  to  modify  the  operational 
state  of  the  logging  console  in  the  volatile  data  base. 

Format: 

SET  LOGGING  CONSOLE  STATE  /0FF\ 

ION  J 

where 

STATE         Sets  the  operational  state  of  the  logging  console  on  the  executor 
node.  When  the  state  is  OFF,  events  are  discarded. 


Example: 


NCP>SET  LOGGING  CONSOLE  STATE  OFF 


This  command  sets  the  state  of  the  logging  console  to  OFF. 
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NCP/S 


SHOW  CIRCUIT 


HP 


l\se  the  SHOW  CIRCUIT  command  to  display  circuit  information  stored  in 
the  volatile  data  hase  (see  Chapter  3). 

Restriction: 

ACTIVE  CIRCUITS  and  KNOWN  CIRCUITS  cannot  he  initiated  locally. 
Format: 


SHOW    [CIRCUIT  circuit-id 
ACTIVE  CIRCUITS 
KNOWN  CIRCUITS 


[COUNTERS 
STATUS 
SUMMARY 


where 

CIRCUIT 

circuit -id 

ACTIVE  CIRCUITS 

KNOWN  CIRCUITS 

COl'NTERS 

STATUS 

SUMMARY 

Example: 


Displays  information  for  the  specified  circuit  only 

Displays  information  for  all  active  circuits. 
Displays  information  for  all  known  circuits. 
See  definitions  in  Section  6.5.2. 


NCP    SHOW    CiryCUlT    DMC-0    COUNTERS 


This  command  displays  error  and  performance  statistics  for  circuit  DMC-O. 
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NCP/S 
SHOW  EXECUTOR 


NP 


I'se  the  SHOW  KXKriTOR  command  to  display  local  node  information 
stored  in  the  volatile  data  base  (see  Chapter  :\). 


Format: 

SHOW  KXKCITOH 


where 

CHARACTKHISTICS 
(X)rNTKHS 
ST  ATI'S     .V. 
Sl'MMAHV 


CHAKACTKHISTICS^ 
(n)r\TKHS 
STATIS 
SIMMAKV 


See  definitions  in  Section  6.'). 2. 


Example: 


NCP  SHOW  E'ECUTOP  S'^ATyq 


This  command  displays  local  node  dynamic  information. 
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NCP/S 

SHOW  LINE 


NP 


I'se  the  SHOW  LINK  command  to  display  line  information  stored  in  the 
volatile  data  base  (see  Chapter  'A). 

Restriction: 

ACTIVK  IJNHS  and  KNOWN  IJNKS  cannot  be  initiated  locally. 
Format: 


SHOW    [LINK  linr-ui 

A(  TIVK  LINKS 
KNOWN  LINKS 


COINTKHS 

STATIS 

SIMMARV 


where 

LINK  lim'-id 

A(TIVK  LINKS 

KNOWN  LINKS 

OOrNTKKS 

STATIS 

SIMMAHV 

Example: 

NCP       ••    - 


Displays  intormation  tor  the  specified  line  only 
Displays  information  for  all  active  lines. 
Displays  information  for  all  known  lines. 
See  definitions  in  Section  i).').'2. 


JMMARV 


This  command  displays  the  most  useful  information  about  line  DMC  I. 
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NCP/S 

SHOW  LOGGING 
CONSOLE 


UP 


I'se  tlu'  SHOW  I.()(;(;iN(;  CONSOLK  coinniaiul  to  display  dynamic  loK^itiK 
console  information  stored  in  the  volatile  data  base  (see  Chapter  Ml. 

Format: 

SHOW  l.OCdINC,  CONSOI.K  S  TATl  S 
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NCP/S 
SHOW  NODE 


NP 


• 


Use  the  SHOW  NODE  command  to  display  node  information  stored  in  the 
volatile  data  base  (see  Chapter  3).  See  the  SHOW  EXECUTOR  command  tor 
executor  node  displays. 

Restrictions: 

•  ACTIVE  NODES  and  KNOWN  NODES  cannot  be  initiated  locally. 

•  No  information  will  be  displayed  for  an  end  node  until  a  link  has  been 
established  to  it.  The  node  may  appear  to  be  unreachable  even  when  it  is 
not. 


Format: 

SHOW   fNODE  node-id 

ACTIVE  NODES 
KNOWN  NODES 


I 


CHARACTERISTICS] 
COUNTERS  L 

STATUS 
SUMMARY 


IJ 


where 

NODE  node-id 

ACTIVE  NODES 

KNOWN  NODES 

CHARACTERISTICS 
COUNTERS 
STATUS 
SUMMARY 

Exampie: 

NCP.>SHOW  NODE  LOSANG  COUNTEkb 


Displays  information  for  the  specified  node  only 
Displays  information  for  all  active  nodes. 
Displays  information  for  all  known  nodes. 
See  definitions  in  Section  6.5.2. 


This  command  displays  error  and  performance  statistics  for  node  LOSANG. 
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NCP/S 


SHOW  SYSTEM 


NP 


Use  the  SHOW  SYSTEM  command  to  display  system  information  stored  in 
the  volatile  data  base  (see  Chapter  ',]). 


Format: 

SHOW  SYSTEM 


!  CHARACTERISTICS 
COUNTERS 
STATUS 
SUMMARY 


where 


CHARACTERISTICS      See  definitions  in  Section  6.5.2. 

COUNTERS 

STATUS 

SUMMARY 

Example: 


NCPSHOW    SVSTEI"'    COUNTETyS 


This  command  displays  system  error  and  performance  statistics. 
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NCP/S 


ZERO  CIRCUIT 


Use  the  ZERO  CIRCUIT  command  to  zero  circuit  counters  for  the  specified 
circuit(s).  The  executor  node  maintains  these  counters  on  a  per  circuit  basis. 

Restriction: 

KNOWN  CIRCUITS  cannot  be  initiated  locally. 

Format: 

ZERO  fcmCllT  circuit-id   \  [COUNTERS] 


\known  circuits/ 


where 


CIRCUIT 

circuit -id 


Zeroes  counters  for  the  specified  circuit  only. 
KNOWN  CIRCUITS      Zeroes  counters  for  all  known  circuits. 


Example: 


NCP>ZERO    CirvCUIT    DUP-0 


This  command  zeroes  circuit  counters  for  circuit  DUP-0. 
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NCP/S 


ZERO  EXECUTOR 


Use  the  ZERO  EXECUTOR  command  to  zero  node  counters  associated  with 
and  maintained  on  the  executor  node. 

Format: 

ZERO  EXECUTOR  [COUNTERS] 
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NCP/S 

ZERO  LINE 


I'se  the  ZERO  LINE  command  to  zero  line  counters  for  the  specified  linelsl 
The  executor  node  maintains  these  counters  on  a  per  line  hasis. 

Restriction: 

KNOWN  LINES  cannot  be  initiated  locally. 

Format: 

ZERO  /line  linc-t(i       \    iCX)lNTERSl 

\knovvn  LINESJ 
where 

KNOWN  LINES      Zeroes  counters  for  all  known  lines. 
LINE  line-id  Zeroes  counters  for  the  specified  line  only. 

Example: 


NCP    ZERO    LINE    DU>.'-3 


This  command  zeroes  line  counters  for  line  DUV-3. 
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NCP/S 


ZERO  NODE 


I'se  the  ZKKO   N'ODF.  command  to  zero  node  rounters  for  the  speeitied 
iiode(s).  The  executor  node  maintains  node  counters  on  a  per  node  basis. 

Restriction: 

This  command  cannot     c  initiated  locally. 

Format: 

ZVMi)    f\()\)K  nnd,  1(1       \    COINIKHSI 
I^KNOWN  .NODKSJ 

where 

NODK  ni>df'.id  Zeroes  counters  for  the  specified  node  only. 

K.NOWN  NODKS      Zeroes  counters  tor  all  known  nodes. 

Example: 


N  C  P    "  ' 


MODES 


This  command  zeroes  node  counters  tor  all  known  nodes. 
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NCP/S 


ZERO  SYSTEM 


I'se  the  ZERO  SYSTEM  command  to  zero  system  counters  associated  with 
and  maintained  on  the  executor  node. 

Format: 

ZERO  SYSTEM  irOlNTERS] 


# 


• 
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Chapter  7 

Console  Carrier  Requester  (CCR) 


The  console  carrier  requester  (CCR)  uses  the  DLX  interface  to  communicate 
with  the  console  carrier  server  (CCS)  residing  on  a  target  node  to  provide 
remote  access  to  normal  console  services.  CCR  is  used  to  emulate  the  console 
on  a  remote  Digital  Ethernet  Communication  Sei  ;er  (DECS)  svstem. 


7.1    Running  CCR 


The  privileged  user  who  wishes  to  invoke  CCR  and  communicate  with  the 
console  carrier  server  must  have  the  PLUTOWL.SYS  and  PLUTOCC.SYS 
files  under  the  network  UIC.  To  access  CCR  (which  has  an  installed  task 
name  of  ...CCR),  use  the  following  command: 


CCR  NODE  node-id 


where 

NODE  node-id 


[SERVICE  CIRCUIT  circuit-id] 
[SERVICE  PASSWORD  password] 
[PHYSICAL  ADDRESS  E-address] 


specifies  the  target  node  by  address  (range:  1  to 
1023)  or  name  (1  to  6  alphanumeric  characters, 
including  at  least  1  alphabetic  character). 

identifies  the  circuit  to  the  target  node,  {circuit-id 
has  the  format  dev-c[-u][.t].) 

defines  the  password  required  to  access  the  target 
node.  The  password  is  a  hexadecimal  number  in 
the  range  of  0  to  FFFFFFFFFFFFFFFF  (up  to  16 
hexadecimal  digits). 

identifies  the  Ethernet  physical  address  that  the 
node  currently  uses  to  identify  itself.  (Required  if 
the  hardware  address  parameter  has  not  been 
specified  in  the  volatile  data  base;  see  the  SET 
NODE  command  in  Chapter  6.) 

The  node-id  is  required.  If  the  other  parameters  are  not  specified  in  the 
command  line,  they  must  be  specified  in  the  down-line  load  data  base.  If  they 
are  specified  in  the  command  line,  they  override  the  parameters  set  in  the 
down-line  load  data  base. 


SERVICE  CIRCUIT 

circuit -id 

SERVICE  PASSWORD 

password 


PHYSICAL  ADDRESS 

E-address 
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7.2  Reserving  the  Console 

The  console  carrier  server  can  be  in  one  of  three  states  when  you  wish  to 
reserve  the  console: 

•  Loaded  and  unreserved 

•  Loaded  and  reserved 

•  Not  loaded 

If  the  console  carrier  server  is  loaded  and  unreserved,  the  console  carrier 
requester  reserves  it,  and  the  following  message  is  displayed  on  your  terminal: 

CCR--Remoiecon5olere5er"ed 

If  the  console  carrier  server  is  loaded  and  reserved,  an  error  message  is  dis- 
played on  your  terminal.  (A  complete  list  of  CCR  error  messages  is  given  in 
Chapter  14.) 

If  the  console  carrier  server  is  not  loaded,  the  requester  loads  the  server.  It 
may  be  necessary  for  the  requester  to  identify  the  target  node  via  the  12- 
hexadecimal-digit  Ethernet  physical  address  if  the  target  node  is  not  known  to 
the  network.  Once  the  server  is  loaded,  the  requester  attempts  to  reserve  the 
console  and  proceed  as  described  above. 

7.3  CCR  Special  Characters 

Two  special  characters  are  supplied  with  the  CCR  software: 

CTf^LB)      Operates  as  a  BREAK  command  to  get  the  attention  of  the  console 
on-line  debugging  tool  (ODT). 

CTRL  D;      Initiates  an  exit  from  console  carrier  mode. 


7.4    Sample  CCR  Session 


In  the  following  sample  session,  the  user  invokes  CCR  to  test  node  DALLAS. 


>CCry  NODE  DALLAS 

CCR  --  Remote  console  is  reseri.'ed 

CTRLg. 


The  system  then  displays  the  current  program  counter  and  a  prompt  ((a  ).  At 
this  point,  you  can  enter  commands  as  if  you  were  physically  located  at  a 
console.  The  command  is  transmitted  by  the  requester  to  the  server,  and  the 
appropriate  response  is  transmitted  by  the  server  to  the  requester.  The  re- 
quester then  displays  this  information. 
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To  examine  a  register,  enter  $  followed  by  the  register  number  and  a  slash  (/). 
To  examine  a  location,  enter  the  address  of  the  location  and  a  slash.  The 
system  then  displays  the  contents  on  the  same  line.  Enter  Clf)  to  view  the  next 
register  or  location,  or  enter  d?)  to  return  to  the  (u  prompt.  When  you  wish  to 
exjt  ODT,  enter  P  (proct  d).  You  must  then  issue  a  ^Pl  to  return  to  the 
RSX  system  prompt. 


0  (.")  Z  1  G  0 
&i"    00000  LP 
Rl  /005G21  ."^ 
R2/  1  12000  IF 
R3/ 000000  l'f 
R4/ 000001  .f 
R5/ 000000  KF' 
@ 100 '0161221^ 
000102/0003^0)1'' 

oooioa/ooiBiaLT 

000 106/ 000  341 H) 

@P  RE' 

fTRL;i)  CCR  --  Remote  cor.  sole  is  released 
> 
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Chapter  8 

Host  Task  Loader  (HLD) 


The  Host  Task  Loader  (HLD)  utility  is  the  down-line  task  loader  service  task 
that  runs  on  the  host  system.  HLD  communicates  with  the  satellite  task 
loader  (SLD)  running  on  a  remote  RSX-llS  system  to  enable  tasks  on  the 
host  system  to  be  down-line  loaded  to  the  remote  node.  You  build  SLD  during 
RSX-llS  network  generation,  and  you  build  HLD  during 
RSX-llM/M-PLUS  network  generation.  For  more  informaticm.  .see  the  I)E('- 
net-RSX  Xetwork  (feneration  and  Installation  Guide. 

HLD  is  driven  by  an  external  mapping  table  that  maps  requests  from  a  task's 
SLD  to  a  file  residing  on  the  host  system.  This  chapter  describes  how  to  build 
and  use  this  mapping  table.  For  more  information  on  down-line  task  loading, 
see  Chapter  4. 

8.1    Formatting  the  HLD  Mapping  Table 

The  mapping  table  is  divided  into  two  logical  sections,  each  containing  a 
different  type  of  task: 

General  purpose  tasks  are  listed  first  in  the  table.  They  are  not  associated 
with  any  particular  node  and  can  be  down-line  loaded  to  any  RSX-llS  node  in 
the  network.  Such  tasks  cannot  be  checkpointed.  Guidelines  for  specifying 
and  using  general  purpose  tasks  follow: 

•  You  can  specify  the  .same  task  name  more  than  once  in  the  genera!  purpo.se 
task  list.  This  allows  RSX-llS  systems  to  share  installed  task  names. 

•  Task  mapping  is  automatically  performed  unless  you  specify  otherwise. 

•  LU\  fixing  (see  Section  8.3)  is  automatically  performed. 

•  You  must  install  general  purpose  tasks  in  the  same  partition  for  all 
RSX-llS  systems,  although  the  partition  addresses  need  not  be  identical 
for  mapped  systems. 

•  If  you  add  new  nodes  to  the  network,  existing  general  purpose  tasks  can  be 
down-line  loaded  to  those  nodes  without  your  having  to  change  the  mapping 
table.  Nodes  receiving  only  general  purpose  tasks  do  not  have  to  be  defined 
in  the  HLD  mapping  table. 
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Node-specific  taslcs  are  always  |)rec'ecie(l  by  a  node  name  in  the  table  and 
can  be  down-line  loaded  to  that  node  only.  .1  you  wish  Ll'N  fixing  to  be 
performed,  you  must  so  specify  (see  Section  H.'A). 

8.2    Creating/Modifying  an  HLD  Mapping  Table 

To  create  or  modify  an  external  HLI)  mapping  table  image,  execute  the 
l.v.l]HLI)I)A'r.CMI)  command  file  presided  by  NK'IHIKN  (v  group  code 
specified  during  NF/r(lKN).  This  command  file  leads  you  through  the  steps 
recjuired  to  specify  your  tasks.  To  get  help  at  any  time  during  the  procedure, 
enter  |sc   in  response  to  a  prompt. 

The  first  prompt  is  for  a  command  string.  Vou  can  enter  any  of  the  following 
commands: 


DKFINK 
FAIT 


i.isr 
qrrr 


Oeates  a  new  node  and 'or  task  entries. 

Terminates  the  session,  replacing  the  old  data  base  contents  and 
optionally  assembling  and  building  the  new  data  base  (same  as 

Displays  a  list  of  the  HLI)  commands. 

Displays  all  node  and  task  entries, 

Delet's  all  old  node  and/or  task  entries. 

Terminates  the  session  with  no  changes  to  the  old  data  base  con- 
tents. 


First  you  define  any  general  purpose  tasks  that  you  wish  to  create  or  modify. 
Fnter  the  task  image  file  name  in  response  to  the  prompt.  You  are  then 
prompted  to  enter  a  task  name  if  you  wish  it  to  be  different  from  the  task 
image  file  name.  Vou  can  also  override  task  mapping  if  you  wish.  When  you 
have  made  all  your  general  purpose  task  entries,  type  1®  to  begin  node- 
specific  task  definitions. 

If  there  are  any  nodes  already  specified,  the  system  displays  each  node  name 
in  turn  and  asks  if  you  want  to  define  any  new  tasks  for  it.  For  each  task  that 
you  define,  you  can  choose  whether  or  not  you  want  Ll'N  fixing  performed 
(.^ee  Section  8.H).  I^ress  ^t  wh^n  you  are  ready  to  define  tasks  for  a  different 
node.  The  system  will  either  display  the  name  of  another  node  that  has 
already  been  specified,  or  it  will  ask  if  you  would  like  to  specify  a  new  node. 
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When  you  have  madi-  all  voiir  task  siH'rifications.  enter  KXIT.  'I'he  svstem 
will  then  ask  it  you  want  to  build  the  new  HLI)  data  base  now.  II  you  do.  it 
prompts  tor  the  DKCnet  ohieet  kit  device  iddu,  where  dd  is  the  device  and  u  is 
the  unit  number).  It  you  choose  to  build  the  data  l)ase  later,  you  can  either 
exeiute  the  HLDDAT  command  tile  a^ain  and  issue  KXIT.  or  you  can  mount 
the  DKCnet  object  kit  on  disk  di-vice  ddu  and  issue  the  lollowinK  commands 
to  create  the  task  ima^e  file. 


SET  /UIC=[1 
MAC  (?HLDTAPASM 
^■^-      '-.   '  A69LD 


8.3    LUN  Fixing 


Ll'N  tixing  is  an  SLI)  feature  that  reinitializes  the  LlNs  after  the  task  ha^ 
been  down-line  loaded.  (This  is  equivalent  to  the  user  pro^'ram  issuing 
ALl'NS  assi^'nments  at  the  start  of  the  program.!  This  feature  allows  a  single 
task  to  be  loaded  into  multiple  HSX  US  systems  that  may  have  different 
unit  control  block  addresses. 

Ll'N  fixing  causes  the  task  transfer  to  be  followed  by  a  copy  of  the  ASCII 
device  assignments.  SLI)  then  assigns  the  loading  task's  I.l'Ns  dynamically. 

Tasks  to  be  down-!ine  loaded  must  be  installed  into  the  KSX   IIS  system. 
I  his  initializes  the  task's  Ll'N  assignments  and  prepares  the  task  image  file 
tor  loading,  h  also  creates  the  HSX    US  system  data  bases  that  allow  the 
tasks  to  be  run. 

U'N  fixing  is  automatic  lor  general  purpose  tasks.  "S'ou  iiiust  specify  it  if  you 
wish  to  perform  Ll'N  fixing  on  a  node-specifi'-  task. 


8.4    HLD  Error  Handling 


The  HLI)  utility  returns  error  messages  resulting  from  file  access  anc'  network 
comnninication  operations  and  from  inconsistencies  in  the  mapping  table  and 
file  to  be  loaded.  Chapter  i4  provides  a  complete  list  of  HLI)  error  messages 
and  their  meanings. 


• 
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Chapter  9 

KMX  Dump  Analyzer  (KDA) 


If  the  performance  of  a  KMX  device  deteriorates  and  this  cannot  be  attrib- 
uted to  a  hardware  fault,  you  can  dump  the  KMX  microcode  for  analysis  by 
your  local  software  specialist.  The  NCP  KMX-DI:MP  command  controls  the 
dumping  of  the  microcode  to  disk  (see  Chapter  6).  The  KMX  dump  analyzer 
task  (KDA)  formats  and  prints  the  contents  of  the  KMX  dump  disk  file. 

You  must  have  included  both  the  dump  KMX  task  (DUK)  and  the  KMX 
dump  analyzer  task  (KDA)  in  your  system  during  NETGEN  if  you  want  to 
use  this  facility.  The  RSX-1]  F'Sf  feneration  Uuide  gives  details  of  the  DUK 
and  KDA  tasks. 


# 


9.1    Invoking  and  Exiting  KDA 


Use  any  RSX-11   method  of  invoking  tasks  to  enter  KDA.  The  .simph 
method  is  to  type: 


>^f 


MCR  ^'•-'^ 


Once  KDA  is  running,  it  returns  the  prompt: 


KDA 


Exit  from  KDA  by  pressing  @RlD 
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9.2    Using  the  KDA  Command 


The  KDA  command  has  the  tbllowing  tbrmat: 

[outfileiswitchcs]    Winfilclsiritchcs]] 
where 

Dutfile  is  the  file  specification  for  the  analyzed  dump  listing  file  (default 
is  SV:[rFD]mpi/fr]r7mr.LST.  where  I'FD  is  the  user's  default  user 
file  directory).  The  symhol  marks  this  as  the  output  file  specifi- 
cation. 

infUe  is  the  file  specification  for  the  hinary  input  file  containing  the 

dump  (default  is  LB:[1.6]PSIKMXMEM.SVS).  Specify  the  same 
file  that  you  specified  for  the  output  file  in  the  KMX-Dl'MP 
LINE  command. 

snitches  are  options  to  control  the  listing  that  KDA  produces.  Any  compat- 
ible combination  of  the  switches  shown  in  Table  9-1  can  be  speci- 
fied for  either  the  input  file  or  the  output  file. 


Table  9-1:    KDA  Command  Switches 


Switch        Meaning 

/ALL  .Analyze  and  print  the  control  memory 

/-.ALL         Analyze  and  print  only  the  data  mem- 
ory and  registers 

/SP  Spool  the  output  file 


/-SP  Do  not  spool  the  output  file 


Comments 


Default  switch 


Default    switch    (Output    is  spooled 
unless  /-SP  is  specified.) 

Output  file  is  retained  fV)r  printing 
later 


Example: 


>KDA 

KDA;'.'ORTEK/ALL  =  DKO:  C7.2l3FROGST.DMP 


This  command  uses  input  file  FROGST.DMP  from  UFD  [7,21]  on  DKO:  and 
prints  an  analysis  of  control  memory  to  output  file  SY:  [UFD] VORTEX. LST. 
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Chapter  10 

Network  Dump  Analyzer  (NDA) 


The  Network  Dump  Analyzer  (NDA)  utility  helps  you  to  determine  the  cause 
of  network  crashes.  NDA  is  a  nonprivileged  task  for  use  only  with  DEC- 
net-RSX  systems,  including  those  with  a  PSN  capability.  If  you  have  selected 
crash  dump  analysis  support  during  RSX  system  generation,  then  you  can 
also  select  network  crash  dump  analysis  support  during  DECnet-RSX  net- 
work generation.  Refer  to  the  RSX-UM  System  Generation  and  Installation 
Guide  for  information  on  obtaining  crash  dump  support  for  your  operating 
system.  Refer  to  the  DECnet-RSX  Network  Generation  and  Installation 
Guide  for  information  on  obtaining  network  crash  dump  support  for  DEC- 
net-RSX. 

NDA  performs  crash  dump  analysis  for  the  network  data  structures  in  the 
same  way  that  the  RSX  crash  dump  analyzer  (CDA)  analyzes  the  operating 
system  data  structures.  Specifically,  NDA  compiles  and  analyzes  information 
from  the  system's  executive  symbol  table  file,  the  network  symbol  table  file, 
and  the  crashed  system  image.  The  information  is  then  output  in  a  listing  file 
or  at  a  line  printer  in  a  format  that  is  useful  to  you.  Note  that  an  effective  use 
of  NDA  requires  an  extensive  knowledge  of  DECnet-RSX  internal  data  struc- 
tures. 

Command  switches  provide  you  with  the  means  to  control  NDA  operation. 
There  are  two  types  of  switches:  analysis  control  switches  and  function  control 
switches.  Analysis  control  switches  determine  which  NDA  analysis  routines 
are  applied  to  the  input  file  for  analysis.  These  switches  provide  such  options 
as: 

•  Dumping  the  contents  of  a  specified  octal  address  range  of  memory 

•  Listing  general  system  data  (time  of  crash,  registers  in  use,  and  so  forth) 

•  Listing  the  routing  parameters  and  data  bases 

•  Listing  the  remote  node  names  and  alias  node  names 

•  Listing  PSI  data  structures  (local  and  remote  DTE  descriptor  blocks,  NW: 
data  base  and  window  blocks,  and  so  forth) 

•  Listing  the  network  services  protocol  (ECL)  data  bases 
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Function  control  switches  provide  a  number  of  NDA  control  options,  such  as: 

•  Identifying  the  starting  block  number  of  the  secondary'  storage  device 

•  Terminating  the  analysis  after  a  specified  number  of  errors  has  been  en- 
countered 

•  Limiting  the  number  of  pages  of  analysis  output 

•  Creating  a  save  file  and  transferring  a  specified  amount  of  the  crash  dump 
to  it 

You  can  type  NDA  commands  at  a  terminal,  or  you  can  place  them  in  an 
indirect  command  file. 


10.1  NDA  Operation 

NDA  operates  in  the  following  manner: 

1.  First,  it  reads  the  contents  of  the  memory  dump  created  by  the  executive 
crash  dump  routine. 

2.  Next,  it  analyzes  the  dump  in  accordance  with  information  contained  in  a 
combined  executive/network  symbol  table  file. 

3.  Finally,  it  formats  and  outputs  the  dump  to  a  line  printer  or  a  listing  file 
for  your  evaluation. 

10.2  System  Requirements 

To  obtain  a  crash  dump  that  can  be  handled  by  NDA,  you  must  first  build  the 
executive  crash  dump  routine  into  your  system  during  phase  1  of  an  RSX-11 
SYSGEN.  This  is  accomplished  by  entering  B  in  response  to  the  query: 

50.  Crash  dump  analysis:  A-  PANIC  B-  Crash  dump  analysis  (CDA) 

If  you  select  this  option,  code  is  included  in  your  system  to  dump  memory  to  a 
secondary  storage  device  following  a  system  crash.  Your  secondary  storage 
device  can  be  any  one  of  a  number  of  different  types  of  disk  units,  a  magtape 
unit,  or  a  DECtape  unit.  You  can  find  complete  information  on  RSX-11 
SYSGEN  in  the  RSX-llM  Sxstem  Generation  and  Installation  Guide. 
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10.3   Obtaining  a  Crash  Dump 

To  obtain  a  crash  dump,  control  of  the  processor  must  be  transferred  to  the 
executive  crash  dump  routine  following  a  system  crash.  How  this  ccmtrol  is 
transferred  depends  on  the  way  in  which  the  crash  occurred  and  whether  or 
not  you  have  built  the  executive  debugging  tool  (XDT)  into  vour  svstem  at 
SYSGEN. 

System  crashes  occur  in  three  ways: 

•  The  processor  encounters  an  unintentional  halt  instruction  (OOOOOO). 

•  An  infinite  loop  condition  occurs. 

•  The  processor  encounters  a  program  condition  causing  it  to  trap. 

When  a  system  crash  is  the  result  of  an  unintentional  halt  instruction  or  an 
infinite  loop  condition,  you  must  restart  your  processor  at  location  40. 

When  a  program  condition  causes  a  processor  trap  and  XDT  is  included  in 
your  system,  control  transfers  automatically  to  XDT.  When  you  type  X  at 
your  terminal.  XDT  transfers  control  to  the  executive  crash  dump  routine. 
When  XDT  is  not  included  in  your  system,  a  processor  trap  causes  control  to 
be  transferred  to  the  crash  dump  routine.  Refer  to  the  RSX-llM  Guide  to 
Writing  an  I/O  Driver  for  a  description  of  XDT. 

Regardless  of  the  manner  in  which  control  is  transferred,  once  the  executive 
crash  dump  routine  is  entered,  it  prints  the  following  message  on  the  crash 
notification  device  specified  during  SYSGEX: 

CRASH     -     CONT    WITH    SCTvATCH    MEDIA    ON    xxx 


where  xxx  is  the  mnemonic  for  the  device  that  is  to  receive  the  crashed  system 
image. 

You  can  then  put  the  secondary  crash  dump  device  on  line  and  depress  the 
CONT  switch  on  the  CPU  console.  The  executive  crash  dump  routine  dumps 
memory  to  the  crash  dump  device  and  halts  the  processor  upon  completion. 
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10.4    Running  NDA 


You  can  run  NDA  as  either  an  installed  or  an  uninstalled  task. 


10.4.1  Running  NDA  as  an  Installed  Task 

When  you  run  NDA  as  an  installed  task,  the  command  format  that  you  use 
determines  where  control  is  returned  upon  completion  of  the  analysis: 

•  To  return  control  to  the  executive: 
>NDA  command  string 

•  To  return  control  to  NDA: 

>NDA 

NDA">  command  string 

10.4.2  Running  NDA  as  an  Uninstalled  Task 

When  you  run  NDA  as  an  uninstalled  task,  control  is  always  returned  to  NDA 
upon  completion  of  the  analysis.  The  commands  for  running  NDA  are: 

Rl'N  $NDA  This  requires  NDA.TSK  to  be  present  in  the  user 

SDA>command  string      file  director\-  corresponding  to  the  system  UIC  on 

device  LB:. 

Rl'X  NDA  This  requires  NDA.TSK  to  be  present  in  the  user 

SDAycommand  string      file  directory  corresponding  to  the  current  UIC  on 

device  SY:. 


10.5    NDA  Command  Syntax 


I'se  the  following  format  to  input  commands  to  NDA: 

[ana/ys/si/.s///]].[sarp[/MEMSIZ:ri)]-[.sym6o/.s/STB].  [input[/su-2]] 
where 


analysis 


/sul 


sate 


is  the  crash  dump  analysis  listing  file.  If  a  file  extension  is  not 
specified,  the  default  extension  is  .LST.  If  an  analysis  file  is 
not  specified,  no  analysis  list  file  is  created. 

consists  of  the  /EXIT:n.  /LIMIT:n.  and  /-SP  functional  con- 
trol switches  for  the  analysis  file.  A  description  of  each  switch 
and  its  default  value  are  given  in  Table  10-3. 

is  the  crash  dump  save  file.  This  file  is  a  copy  of  the  binary 
data  that  was  written  to  the  dump  device  by  the  dump  rou- 
tine. It  allows  you  to  create  a  historical  record  of  crash 
dumps. 
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s\mh()is/STH 


input 


/siv2 


AlKMSIZ.v?        is  the  luimhtT  of  K  words  of  information  to  be  transferred  to 

the  save  file.  A  description  of  the  MKMSIZ:^?  funetional  con- 
trol switch  and  its  detaull  vahie  are  ^iven  in  Table  10  .'I 

is  the  symbol  table  file  for  the  crashed  system.  'I'his  file  must 
define  all  executive  and  network  symbols.  A  description  ot 
/STB  and  its  default  value  are  ^iven  in  Table  \():\. 

is  the  binary  input  to  NDA.  This  specification  can  be  either  a 
device  name  (your  secondary  storage  device)  or  the  name  of  a 
'•rash  dump  save  file. 

consists  of  all  the  analysis  control  switches  and  three  func- 
tional control  switches  -  /KMH.  /SYM.  and  /H\.:n.  A  de- 
scription of  the  analysis  control  switches  is  provided  in  Sec- 
tion 10.7.1.  A  description  of  the  /KMK.  /SYM.  and  /H\/.n 
switches  and  their  default  values  are  given  in  Table  10  M. 

()utj)ut  specifications  (to  tne  leit  of  the  equal  sign)  are  position  dependent. 
Therefore,  when  you  include  both  output  specifications  (analysis,  save),  you 
must  place  them  in  the  command  string  in  the  positions  shown.  If  you  do  not 
enter  a  specification  for  the  analysis  file,  you  must  place  a  comma  before  the 
save  file  specification.  The  comma  can  appear  only  if  a  save  file  is  specified. 

Input  specifications  (to  the  right  of  the  equal  sign)  are  position  independent 
and  can  appear  in  either  order. 

Any  of  the  specifications  in  the  command  string  can  appear  in  the  complete 
FILES-Il  format  -  that  is.  complete  with  device.  TIC.  file  name,  file  type, 
and  version  number.  When  vou  omit  any  of  the  command  specifications.  NDA 
uses  the  defaults  shown  in  Table  10- 1. 


• 


Table  10-1:    NDA  File  Default  Values 


User  File 

Directory 

Default 

Value 

File 

Device 

(UFD) 

File  Name 

Type 

.Analv><is  tile 

SV: 

Current 

None 

.l.ST 

.Save  rile 

SV: 

Current 

N'diie 

.CI)..\ 

Symbols  tile 

SV: 

Current 

CKX 

.SIM 

Input  lile 

SY: 

Current 

None 

.C  DA 
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The  following  examples  illustrate  the  NDA  file  default  values.  Assume  that 
the  user  in  these  examples  is  logged  in  under  UIC  [301,356]  and  that  the 
secondary  storage  device  is  DKl:.  Also  assume  that  NDA  is  being  operated  as 
an  installed  task. 

Example  1: 

>NDA 

NDA'>  18APry8Z.18APrv82  =  CE;;.STB/5TB.DKl:/ALL 


This  command  string  creates  an  analysis  file,  18APR82.LST,  and  a  save  file, 
18APR82.CDA.  The  binary  input  is  read  from  RK05  disk  unit  1.  NDA  ana- 
lyzes it  in  accordance  with  the  information  contained  in  the  svmbol  definition 
file  CEX.STB  under  UFD  [301,356]. 

Example  2: 

)NDA 

NDA  >  .  13JAN82  =  DK I  : 


This  command  string  creates  a  save  file,  13JAN82.CDA.  In  this  case,  NDA 
performs  no  analysis,  since  there  is  no  analysis  listing  file.  The  binary  input  is 
read  from  RK05  disk  unit  1. 

Example  3: 

>  M  D  A 

NDA  M3JAN82=  13JAN8Z/ALL 

This  command  string  produces  an  analysis  output  listing  using  the  /ALL 
analysis  switch  (see  Table  10-2  for  a  complete  description  of  this  switch).  The 
binary  input  is  read  from  the  previously  created  save  file  {13JAN82.CDA). 
NDA  analyzes  it  in  accordance  with  the  information  contained  in  the  symbol 
definition  file  CEX.STB  under  UFD  [301,356]. 

Example  4: 

>NDA 

NDA>  13JAN82  .  1  3JAN82  '^1EMSIZ:?1Z^:^  1  :  .  ALL 

This  command  string  creates  an  analysis  file  named  13JAN82.LST  and  a  save 
file  named  13JAN82.CDA.  The  number  of  words  of  information  to  be  trans- 
ferred is  512K  words.  The  input  file  is  located  on  RK05  disk  unit  1.  NDA 
produces  an  analysis  output  listing  using  the  /ALL  analysis  switch. 


10.6    Indirect  Command  Files 


You  can  enter  command  strings  to  NDA  directly  from  the  keyboard  or  indi- 
rectly through  the  use  of  the  indirect  command  file  facility.  NDA  indirect 
command  files  must  not  contain  a  reference  to  another  command  file. 
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10.7    NDA  Switches 


Switches  provide  you  with  the  means  tc  control  NDA  operation.  There  are  two 
types:  analysis  control  switches  and  functional  control  switches. 

Analysis  control  switches  determine  which  NDA  analysis  routines  are  to  he 
applied  to  the  input  file.  Some  switches  apply  only  to  the  DECnet  software, 
while  others  apply  only  to  the  PSI  software  running  with  DECnet  on  a  DEC- 
net-RSX  system  with  a  PSN  capability. 

Functional  control  switches  provide  a  number  of  NDA  control  options.  For 
example,  such  switches  might  terminate  an  analysis  after  NDA  has  encoun- 
tered a  specified  number  of  errors.  Or,  a  switch  might  limit  the  number  of 
pages  of  output  listing. 

10.7.1    Analysis  Control  Switches 

Table  10-2  provides  a  list  of  the  analysis  control  switches  and  a  brief  descrip- 
ti(m  of  their  use.  More  than  one  analysis  control  switch  can  be  specified.  If 
none  are  specified,  the  default  is  /SYS/CEX. 
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Table  10-2:    NDA  Analysis  Control  Switches 


Switch 

/ALL 


/CEX 


/CTB 

/cic; 

/DST 

/DS\P:a:h 
/DUMP:n:6 

/LDTE 

/LIS 
/LIST 
/LISTS 
/FREE 

/NSP 

/NW 

/OB.I 
/OBJECT 

/PDV 

/PHB 

/PLI 

/PRO 
/PROC 

/PSV 

/PVC 

/QUE 
/QUEUE 

/RDTE 


Description 

Executes  the  tbllowinp  switches  (each  is  defined  later  in  this  table): 

/CEX  /l.DTE  /OB.I  /I'RO  l^DTE  /SYS 

/CTB  /LIS  /PD\-  /I\SV  /REM  AFSK 

/cue,  /NSP  /I^HB  /PVC  /ROU  /XACP 

/DST  /NW  /PLI  /QUE  /SLT 

DECnet.  PSI.  and  X.'25  Gateway  components  are  analyzed  only  if  the 
respective  soffvare  was  in  the  system  that  was  dumped.  /ALL  is  the  rec- 
ommended switch  to  use.  If  problems  occur,  then  tr\'  using  specific 
switches. 

Lists  general  Communications  Executive  data.  This  includes  the  node 
name  and  number,  the  current  network  process,  and  the  current  state  of 
buffer  usage. 

Prints  information  on  all  controller  blocks  assigned  to  network  devices. 
(This  is  printed  only  on  RSX-  llM-PLUS  systems.) 

Prints  the  PSI/X.2n  Gateway  closed  user  group  name  blocks. 

Prints  the  PSI/X.2n  Gateway  X.25  and  X.29  destination  blocks. 

Lists  the  contents  of  physical  memory  from  octal  address  a  through  octal 
address  h.  Both  a  and  b  are  32-bit  addresses. 

Prints  the  PSI/X.25  Gateway  local  DTE  descriptor  blocks. 

Scans  the  CCB,  SDB.  and  RDB  free  lists  for  errors  and  prints  the  results. 


Fr'uts  the  DECnet  ECL  data  bases,  including  the  logical  link  blocks. 
Prints  the  PSI  NW:  data  base  and  window  blocks. 
Lists  the  network  task  object  types. 

Prints  interpreted  contents  of  the  process  description  vectors. 

Prints  the  contents  of  the  PSI/X.25  Gateway  PLI  home  block. 

Prints  the  PSI  PLI/X.2o  Gateway  data  base  and  the  X.25  circuit  blocks. 

Dumps  the  line  tables  for  all  loaded  network  processes. 


Prints  the  X.25  Gateway  PSV  process  data  bases,  circuit  data  ba.ses,  and 
buffer  chains. 

Prints  the  PSI/X.25  Gateway  permanent  virtual  circuit  (PVC)  name 
blocks. 

Lists  the  contents  of  the  fork  process  queue. 


Prints  the  PSI  remote  DTE  descriptor  blocks. 
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Table  10-2  (cont.):    NDA  Analysis  Control  Switches 


Switch 

/'HKM 
/RKMOTK 

/Ror 

/-ROIT 
HOITINC; 

SLT 

/SYS 

TSK 
TASK 

/XACP 


Description 


I-ists  the  DKCru't  remoto  node  nanu's  aiul  alias  names. 


Lists  the  DKCnet  routing'  fxirameters.  incliidiiig  the  physical  link  hltxks. 


F'rints  interpreted  contents  of  the  system  line  tahles. 

Lists  fienera!  system  data.  This  includes  the  tune  ot  the  crash,  [hv  current 
task,  and  the  registers  in  use. 

Prints  the  network  mailbox,  window  blocks,  and  I  ()  packets  for  each  ta>k 
using  the  network. 

Prints  the  CCHs  and   I  ()  packets  waiting  to  be  |)rocessed  bv  the  I'Sl 

\2nACP. 


10.7.2    Function  Control  Switches 

Table  10-3  provides  a  list  of  the  function  control  switches  and  a  brief  descrip- 
tion of  their  use.  More  than  one  function  control  switch  can  be  specified.  If 
switches  are  not  specified,  the  default  values  listed  in  Table  10-3  are  as- 
sumed. Note  that  when  a  switch  requires  a  numeric  argument,  the  argument 
is  considered  to  be  octal  unless  followed  by  a  decimal  point. 


10.8    NDA  Error  Messages 


• 


\DA  prints  an  error  message  on  your  terminal  when  it  detects  an  error  condi- 
tion. NDA  error  messages  are  summarized  in  Chapter  14.  Do  not  confuse  these 
messages  with  the  diagnostic  analysis  messages  that  NDA  generates  during 
the  analysis  and  prints  in  the  analysis  listing. 
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Table  10-3:    NDA  Function  Control  Switches 


Switch 

Default 
/BL:m 


Flit 

Input  file 


/KXITin 


Analvsis  tile 


/KMR 


Input  tile 


/IJMIT:n 


Analvsis  file 


/MKMSIZ:n 


Save  tile 


Dttcrlptlon 


Identifies  the  starting  hlock  num- 
ber ot  the  secdndary  storage  device. 
The  value  of  n  must  he  less  than 
6553 'i. 

NDA  reads  the  dump  from  the  in- 
put device  he^jinnmp  at  logical 
block  n.  If  the  crash  dump  device  is 
not  a  disk  or  DKCtape.  NDA  ig- 
nores this  switch. 

Terminates  analysis  after  en- 
countering n  analysis  errors. 

NDA  maintains  an  error  coimt.  If 
you  specify  the  'KXIT:n  switch, 
NDA  terminates  analysis  after  n  er- 
rors. If  you  specify  /FIXIT  but  do 
not  specify  n.  NDA  exits  after  one 
error. 

When  NDA  reads  incorrect  page 
address  register  (PAH>  values  from 
the  crash  stack,  it  prints  an  error 
message  on  the  user's  terminal  and 
attempts  to  continue  with  the  anal- 
ysis. In  this  event,  you  can  use  the 
/KMR  switch  when  you  restart  the 
analysis. 

/KMH  forces  NDA  to  u.se  standard 
mapping  values  to  convert  kernel 
virtual  addresses  to  physical  mem- 
ory addresses. 

Limits  the  number  of  pages  of  anal- 
ysis output.  When  NDA  has  gener- 
ated n  pages,  it  terminates  the 
analysis  and  prints  a  message  on 
♦he  user  terminal  indicating  that  it 
has  done  so. 

Creates  a  save  file  -ixn  blocks  long 
and  transfers  nK  words  to  it  from 
the  input  file.  The  valid  range  of 
decimal  values  ff)r  n  is  from  IH  to 
4f>9«. 

This  switch  is  necessary  only  when 
saving  dumps  from  secondary  stor- 
age devices  that  have  no  VX)Vs 
(disk  or  DPXtape).  When  the  crash 
input  resides  on  magtape,  the  save 
file  is  zero  filled  if  the  KOF  is  read 
before  nK  words  have  been  trans- 
ferred. 


Default 


/BL:1 


-KXir 


/- 


/ITMIT.oO 


/MKMSIZ:1LM 
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Table  10-3  (cont.):    NDA  Function  Control  Switches 


Switch 

/-SP 

SIB 


Fll« 


Analysis  file 


Symbols  file 


SYM 


Input  tile 


Description 


Causes  NDA  to  not  spool  the  analy- 
sis output  iistin^j  file  to  the  line 
pruiter. 

Identifies  the  file  that  contains 
hoth  the  executiye  and  the  network 
symhol  tables  for  the  crashed  sys- 
tem NDA  open>  the  specified  file 
and  extracts  the  necessary  symbol 
yalues.  If  it  fails  to  find  any  re- 
(juired  symbol  yalues.  NDA  aborts 
the  analysis  and  prints  an  error 
message  tin  the  terminal. 

Il  no  symbol  is  specitied  yia  the 
/STB  switch.  CKX  STB  under  the 
current  I'lC  is  used. 

It  any  recjuired  symbols  are  not 
found  in  the  symbol  table  tile,  set 
their  yalues  to  zero  and  proceed 
with  the  analysis.  Normally,  this 
(•indition  would  cause  ND.A  to 
abort  the  analysis. 


Default 


/SP 


CKX  STB  in 
the  current 

lie 


SYM 
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Chapter  11 

Network  Display  Program  (NTD) 


The  Network  Display  Program  (NTD)  lan  provide  two  types  ot displays: 

•  A  resource  display  ot  the  current  status  ot  the  host  node  or  any  specitied 
remote  HSX/IAS  DKCnet  node  in  the  network.  There  are  two  tormats  tor 
this  disphiy: 

Default  resource  display  for  current  DKC'net   HSX  systems  (see  Fijjure 
11-1) 

Old  resource  display  tor  connections  to  DKCnet   HSX  systems  having  pre- 
vious versions  ol  the  software  (see  Figure  112) 

•  A  node  summary  display  of  all  reachable  nodes  or  a  user-specified  range  of 
nodes  in  the  network  (see  Figure  1 1  .'0 

You  can  review  a  continuously  updated  screen  display  on  any  \'T1()0  or  VT52 
terminal,  or  you  can  use  NTD  with  a  hard-copy  terminal  to  obtain  a  listing  of 
the  display  information.  The  displayed  information  is  collected  by  NTDKMO. 
a  task  that  runs  on  the  system  tor  which  you  are  disi)layiMg  intormation. 

'i'his  chapter  describes  the  displays  and  outlines  the  commands  rec^uired  to 
invoke  and  customize  the  displays. 


11-1 


11.1    Invoking  NTD 


Tse  the  following  command  to  invoke  NTD: 

NTD  [n(>dv-namc][^PAGE--^s] 

where 

node-name  is  a  name  consisting  of  1  to  6  numeric  or  alphabetic  characters, 
including  at  least  1  alphabetic  character.  If  you  do  not  specify 
node-nnm(\  NTD  displays  the  status  of  the  local  node. 

/PAGE-*'  is  a  switch  that  specifies  the  display  type,  where  >  is  one  of  the 
following: 

R      Default  resource  display 
O      Old  resource  display 
N      Node  summary  display 

This  switch  is  most  useful  when  running  NTD  from  a  hard-copy 
terminal.  Without  this  switch,  you  will  always  get  a  re.source 
display.  NTD  automatically  checks  the  version  of  the  specified 
node  to  determine  whether  to  display  the  default  resource  dis- 
play or  the  old  resource  display.  From  a  VTKK)  or  a  VTo'i.  you 
can  switch  to  a  node  summary  display  simply  by  entering  esC;. 

Error  messages  that  can  be  generated  when  you  invoke  NTD  are  listed  in 
Chapter  14. 


11.2    NTD  Commands 


NTD  commands  control  various  aspects  of  the  real-time  NTD  displays.  There 
are  two  modes  of  operation  for  NTD  commands: 

•  Immediate  mode.  With  the  NTD  display  on  your  .screen,  you  enter  com- 
mands to  directly  manipulate  the  display  -  for  example,  to  ccmtrol  scroll- 
ing of  display  information  or  to  change  to  a  different  display. 

•  Command  mode.  When  you  switch  from  immediate  mode  to  command 
mode.  NTD  displays  the  commands  that  you  can  enter  to  customize  the 
display  —  for  example,  to  change  the  frequency  of  display  updates  or  the 
range  of  nodes  for  which  NTD  is  to  display  information.  In  this  mode.  NTD 
prompts  for  commands.  You  must  return  to  immediate  mode  to  view  the 
displays. 

The  use  of  each  mode  and  its  commands  is  defined  in  the  following  sections. 

11.2.1    Immediate  Mode  Commands 

When  you  invoke  NTD.  you  automatically  enter  immediate  mode.  Enter  any 
of  the  commands  de.scribed  in  Table  111  to  directly  manipulate  the  screen 
display.  The  terminal's  bell  will  ring  if  you  enter  an  unrecognized  command. 
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Table  11-1:    Immediate  Mode  Commands 


Character  Kay 

R 
O 

N 

•  space  har - 

D 

T 

B 

■♦■ 


S 
H 


£trl7  or  etRig. 


Function 

Changes  t(»  default  resoiirt'e  display 

Chancres  to  old  resourte  display 

Changes  tn  node  summary  display 

Refreshes  the  lurrently  selected  display 

Selects  scrolling  o|  nof^e/circuit  information  only  (default  i 

Selects  scrolling  of  task  information  onlv 

Selects  simultaneous  scrolling  of  node  and  task  inft»rmation 

Scrolls  currently  selected  information  forward  .')  items  at  a  time  tor 
resource  displays  or  10  nodes  at  a  time  tor  node  summary  displays  * 

Scrolls  currently  selected  information  backward  .'>  items  at  a  time  for 
resource  displays  or  10  nodes  at  a  time  for  node  summary  displays  * 

Sorts  selected  information  in  ascending  order  by  node  address  instead 
of  alphabetically  by  node  name 

Displays  help  information  tor  immediate  mode  commands  for  ")  sec- 
onds,  then  redisplays  the  currently  selected  \'Vl)  staius  information 

Knters  command  mode 

Kxits  NTI) 


Scrolling  causes  information  to  be  displayed  for  a  range  of  nodes,  beginning  with  the  next 
available  node  that  is  five  reachable  addresses  ahead  of  (or  behind)  the  currently  speci- 
fied starting  node.  On  the  node  summary  display,  a  maximum  of  84  nodes  can  be  dis- 
played on  the  screen  at  once.  Inless  you  enter  the  S  command  (see  above),  nodes  are 
displayed  in  alphabetic  order  by  name.  Therefore,  scrolling  bv  node  address  will  cau.se 
the  order  to  change. 


11.2.2    Command  Mode  Commands 

When  you  enter  W)  to  switch  from  immediate  mode  to  command  mode,  the 
pos.sible  commands  you  can  enter  are  displayed  on  your  screen,  followed  by  a 
command  prompt.  Valid  commands  are  described  in  Table  11-2.  Enter  one 
command  for  each  prompt. 

When  entering  these  commands,  you  need  only  use  a  single  character  to 
designate  the  command.  For  example,  the  commands  ADDRESS-4  and  A -4 
both  .set  4  as  the  lowest  node  address  for  which  information  is  to  be  displayed. 
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Table  11-2:    Command  Mode  Commands 


Command 

NTIME  n 

TTlME-n 
ADDRESS -n 
MAXIMUM   n 
HOPS   n 
COST-n 


Function 

Sets  the  time  (in  seconds)  between  display  updates  Inr  remote  nodes 
(default:  10  seconds) 

Sets  the  time  (in  seconds)  between  display  updates  I'or  network  tasks 
and  circuits  (default:  5  seconds) 

Sets  the  lowest  node  address  tor  which  information  is  to  be  displayed 
(ranpe:  1  to  1023;  default:  node  1)  * 

Sets  the  highest  node  address  for  which  information  is  to  be  displayed 
(range:  1  to  1023;  default:  node  1023)  * 

Sets  the  maximum  number  of  hops  allowed  to  a  remote  node  to  be 
displayed  (default:  .31)  * 

Sets  the  maximum  cost  allowed  for  a  remote  node  to  be  displayed 
(default:  1023)  * 

Reverts  to  the  currently  selected  display  and  immediate  mode 

Exits  NTD 


*    If  you  specify  0  for  n,  the  value  will  revert  to  the  specified  default. 

11.3    NTD  Resource  Display  Format 

Figures  11-1  and  11-2  are  examples  of  the  default  resource  display  and  the  old 
resource  display,  respectively.  The  display  information  fields  are  descrihed 
below. 

Top  of  the  screen 

•  The  current  date  and  time  at  the  node  where  NTDEMO  runs.  This  is 
updated  approximately  every  second. 

•  The  name  and  identification  of  the  node  being  displayed.  For  VTlOO  termi- 
nals. NTD  uses  the  VTlOO  graphics  capability  to  highlight  the  name  of  the 
node. 

•  Bar  graphs  for  the  following  resources: 
Logical  links  (LNKS) 
Communication  control  buffers  (CCBs) 

NOTE 

Because  CCBs  can  be  allocated  dynamically,  the  total  num- 
ber of  CCBs  available  can  varv. 
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Small  data  buffers  (SDRs) 

Large  data  buffers  (LI)Bs) 

The  first  set  of  numbers  for  each  resource  indicates  the  number  of  that 
resource  currently  in  use  and  the  total  number  generated  into  the  system. 
For  example.  12/50  in  the  LDB  line  in  Figure  11-1  indicates  that  12  out  of ')() 
generated  large  data  buffers  are  currently  being  used. 

The  actual  graphs  represented  by  Xs  in  the  examples  illustrate  the  percent- 
age of  each  resource  currently  in  use.  The  vertical  bars  on  the  graph  (repre- 
sented by  I  in  the  figures)  illustrate  the  highest  percentage  of  each  resource 
used  during  the  current  invocation  of  NTD.  For  example,  in  Figure  11-1, 
roughly  25  percent  of  the  LDBs  are  currently  in  use.  but  the  position  of  the  ! 
shows  that  approximately  50  percent  of  the  generated  buffers  have  been  in 
use  at  once  during  the  current  invocation  of  \TI).  Bar  graphs  for  each 
resource  are  scaled  independently;  for  example,  an  X  on  one  graph  may 
represent  usage  of  one  of  that  resource,  while  an  X  on  another  graph  may 
represent  usage  of  five  of  that  resource.  Actual  graphic  representations  can 
differ  depending  on  terminal  type. 

At  the  end  of  the  line.  NTD  displays  the  number  of  allocation  failures  for 
each  resource  type  since  network  startup.  On  the  LDB  line,  the  second 
allocation  failure  field  refers  to  receive  data  buffers. 

The  bar  graph  display  is  updated  approximately  every  second. 
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Figure  11-1:    Sample  Default  Resource  Display 
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Lower  left  of  the  screen.  This  data  differs  with  the  two  resource  display 
types,  as  described  below.  For  either  type,  this  information  is  updated  at  the 
interval  specified  by  the  NTIME  command  (default:  every  10  seconds). 

•  Default  resource  display  (see  Figure  11-1).  NTD  displays  the  following  in- 
formation for  all  known  circuits: 

The  circuit  name. 

The  cost  to  reach  the  adjacent  node. 

The  maximum  buffer  size  of  network  messages  to  the  adjacent  node  (not 
applicable  for  Ethernet  circuits,  since  each  node  on  the  Kthernet  may  have 
a  different  size). 

For  point-to-point  circuits,  the  name  and  address  of  the  adjacent  nodo  on 
the  circuit,  if  it  is  reachable;  otherwise,  the  status  of  the  circuit. 

•  Old  resource  display  (see  Figure  11-2).  NTD  displays  the  following  informa- 
tion for  any  node  that  is  currently  reachable: 

The  remote  node  name  and  its  node  address. 

The  name  of  the  circuit  over  which  packets  are  sent  to  the  node. 

The  minimum  number  of  hops  required  to  reach  the  node  and  the  minimum 
cost  to  reach  the  node.  These  numbers  may  correspond  to  different  routes, 
as  the  least  costly  route  may  not  necessarily  have  the  fewest  hops. 

The  number  of  active  logical  links  to  that  node  and  the  current  round  trip 
delay  in  seconds.  If  the  number  of  logical  links  is  shown  as  0.  it  indicates 
that  a  link  has  been  active  to  that  node  since  the  network  was  loaded. 
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Figure  11-2:    Sample  Old  Resource  Display 
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Lower  right  of  the  screen.  NTD  displays  the  following  information  Cor  cur- 
rently active  network  tasks  (that  is.  those  tasks  that  have  issued  an  OPN$  to 
the  network): 

•  The  task  name. 

•  The  TI:  device  associated  with  the  task.  Tasks  requested  throujih  the  net- 
work normally  run  with  a  TI:  ot  COO:  tor  KSX  llM  and  M  PIT'S. 

•  The  number  of  logical  links  that   are  active  on  the  task,  including  any 
outgoing  connect  request  that  has  not  yet  completed. 

•  The  number  of  entries  on  the  task's  mailbox.  Kntries  can  include: 
Incoming  connect  requests 

Interrupt  messages 

Disconnect  notifications 

Link  abort  notifications 

Network  abort  notifications 

Network  events 

Refer  to  the  DhX'nrtHSX  Proiirammrr's  Hvfvmu-v  Manual  for  more  infor- 
mation about  mailboxes. 

•  The  number  of  outstanding  logical  link  transmit  requests. 

•  The  number  of  f)Utstanding  logical  link  receive  requests. 

This  information  is  updated  at  the  interval  specified  by  the  TTIMK  command 
(default:  everv  .^  seconds). 


11.4    NTD  Node  Summary  Display  Format 

Figure  11-.'^  is  an  example  of  a  node  summary  display.  The  display  informa- 
tion fields  are  d    cribed  below. 

Top  of  the  screen 

•  The  current  date  and  time  at  the  node  where  NTDP^MO  runs.  This  is 
updated  approximately  every  second. 

•  The  name  and  identification  of  the  node  being  displaved.  For  VTlOO  termi- 
nals. NTD  uses  the  VTlOO  graphics  capability  to  highlight  the  name  of  the 
node. 
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Node  entries 

•  Node  name  or  address.  By  default,  named  nodes  are  listed  al|)hal)etiially, 
followed  by  nodes  that  are  identitied  by  address  only  (in  astendinK  order). 
You  can  use  the  immediate  mode  S  rommand  to  order  all  nodes  by  ascend- 
ing node  address  (see  Table  111). 

•  The  minimum  number  of  hops  required  to  reach  the  node  and  the  minimum 
cost  to  reach  the  node.  These  numbers  may  corresj)ond  to  different  routes, 
as  the  least  costly  route  may  not  necessarily  have  the  fewest  hops. 

•  The  number  of  active  logical  links  to  the  node.  If  the  number  of  logical  links 
is  shown  as  0.  this  indicates  that  a  link  has  been  active  to  that  node  since 
the  network  was  loaded. 

•  The  total  number  of  nodes  actually  displayed.  Since  the  screen  cannot 
display  more  than  84  nodes  at  once,  this  number  may  not  necessarily  reflect 
the  total  number  of  nodes  in  a  large  network.  You  will  have  to  use  scrolling 
to  display  additional  nodes.  This  number  also  does  not  include  any  nodes 
that  have  been  excluded  because  of  filtering  commands  (see  ADDHKSS, 
MAXINU'M.  HOPS,  and  COST  in  Table  112). 
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Figure  11-3:    Sample  Node  Summary  Display 
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Chapter  12 

Queue  Manager  (QUE) 


The  Queue  Manager  (QUE)  utility  is  the  interface  to  the  RSX-llM  V4.()  and 
RSX-llM-PLUS  V2.0  queue  manager.  Any  privileged  user  can  employ  QUE 
to  initialize  the  File  Transfer  Spooler  (FTS)  queue  and  processor  and  to 
manipulate  user-queued  FTS  requests.  FTS  is  a  DECnet-RSX  utility  that 
allows  you  to  transfer  files  in  much  the  same  way  as  the  Network  File  Transfer 
(NFT)  uiility.  with  the  additional  queue  feature. 

This  chapter  outlines  components  required  by  FTS  and  QUE  and  describes 
how  to  invoke  and  use  QUE.  For  more  information  on  both  utilities,  including 
error  messages,  see  the  following  manuals: 

•  DECnet-RSX  Guide  to  L'ser  Utilities.  Contains  a  complete  description  of 
FTS 

•  RSX-11M/M-PLL\S  Batch  and  Queue  Opentions  Manual.  Contains  a  de- 
scription of  QUE  user  commands  and  error  messages 

•  RSX-llM/M-PLCS  System  Management  Guide.  Contains  a  description  of 
QUE  system  manager  commands 

12.1    FTS  and  QUE  Components 

Table  12-1  lists  the  components  required  by  FTS  and  QUE  and  describes 
their  relationship  to  queue  management.  Figure  12-1  diagrams  the  relation- 
ships among  these  components. 


12-1 


Table  12-1:    FTS  and  QUE  Components 


Component 

F'l'S 

QMC. 

FTSDEQ 

KAL 

rrsQiE 

IKBs 


FTSSYS.LOC, 


FAL.UKi 


Description 

The  liner  interface  that  sp(H)ls  requests  and  places  them  on  a  (|iu'ue. 

The  system  manajjer  interface  that  processes  (jueiie  management  com- 
mands. 

The  RSX  1 1  queue  manager  task. 

The  processor  task  that  services  the  queue. 

The  File  Access  Listener  that  handles  tile  access  and  transfer  requests 
over  a  line  at  the  remote  node. 

The  queue  of  FTS  jobs  that  the  queue  manager  stores  in  a  disk  area. 

I'ser  request  block  files  that  contain  details  (tf  the  FTS  requests  corre- 
sponding to  FTS  jobs  on  the  queue  This  information  contains  names 
that  FrSPKQ  needs  to  process  the  requests.  FTS  prints  this  informa- 
tion in  response  to  the  LIST  command 

The  log  lile  that  contains  a  record  of  both  completed  and  uncompleted 
FTS  jobs. 

The  log  file  that  contains  a  record  of  completed  P'AL  jobs. 


SYSTEM  MANAGER 


Figure  12-1:    FTS  and  QUE  Components 
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12.2    Invoking  QUE 


Use  the  tbllowing  command  to  invoke  Ql'R: 
MCR^Ql'E  command 

where  command  is  any  valid  QTK  command.  Alter  the  Ql'K  command  exe- 
cutes, you  are  returned  to  MCf^. 


12.3    QUE  Command  Syntax 


QUE  supports  three  command  formats.  Each  format  allows  you  to  perform 
various  queue  management  functions.  These  functions  include: 

•  Initializing/deleting  and  starting/stopping  the  queue  and  the  processor 

•  Assigning/deassigning  the  processor  to/from  the  queue 

•  Holding,  releasing,  or  deleting  FTS  user  jobs  on  the  queue 

The  following  sections  describe  the  three  command  formats  and  their  func- 
tions and  give  examples  of  their  use. 

12.3.1    Initializing/Deleting  and  Starting/Stopping  the  Queue  and 
the  Processor 

Use  the  following  QUE  command  syntax  and  the  appropriate  switch  to  cause 
the  queue  or  the  processor  to  be  initialized,  deleted,  started,  or  stopped: 

MCR>QUE  name/switch 


where 


name 


is  either  the  queue  name  (FTSQUE)  or  the  processor's  installed 
name  (FTSDEQ). 


switch      is  one  of  the  following  switch  options: 


CR 

SP/EX 

STA 

STO:QUE 

STO 

DEL:Q 

UNSP 


creates,  names,  and  starts  the  FTS  queue 

creates,  names,  and  starts  the  FTS  processor 

starts  the  FTS  queue  or  processor 

stops  the  FTS  queue 

stops  the  FTS  processor 

deletes  the  FTS  queue 

deletes  the  FTS  processor 


In  an  emergency  situation,  delete  either  the  queue  or  the  processor.  Users  can 
delete  their  jobs  from  the  queue  using  FTS. 

NOTE 

If  FTS  was  selected  during  NETGEN,  the  FTS  queue  and 
processor  will  already  be  set  up  when  the  network  is  loaded.  If 
they  were  not  set  up  by  commands  in  file  NETINS.CMD,  you 
must  create  the  queue  and  start  the  processor  to  make  the  FTS 
queue  available  for  users. 
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Example: 


MCR>0'JE  FTSOUE/Cfy 
MCR  QUE  FT5DE0/SP/E)( 


The  first  command  creates  the  FTS  queue.  The  second  command  starts  the 
FTS  processor  task. 

12.3.2   Assigning  and  Deassigning  the  Processor 

I'se  the  following  QUE  command  syntax  to  assign  and  deassign  the  processor 
to  and  from  the  queue: 

MCR>QUE  FTSDEQ:/,s7r/>t/?:FTSQl'E 

where 


FTSDEQ 
FTSQUE 

snitch 


is  the  processor  name. 

is  the  queue  name. 

is  one  of  the  following  switch  options: 

AS  assigns  the  processor  to  the  queue.  You  must  assign  the 
processor  upon  initializing  it  in  order  to  enable  FTS  opera- 
tions. 

DEA  deassigns  the  processor  from  the  queue.  Deassigning  the 
processor  prevents  it  from  performing  any  functions  (for 
example,  transferring  files,  despooling).  However,  jobs  can 
be  added  to  the  queue  when  the  processor  is  deassigned. 
You  may  need  to  deassign  the  processor  in  special  situa- 
tions (for  example,  to  prevent  jobs  from  being  completed). 
To  reactivate  the  processor,  use  the  assign  switch  (/AS). 

There  are  cases  where  a  queue  must  be  inspected,  but  you  do  not  want  any  of 
the  jobs  processed  before  listing  the  queue's  contents.  In  this  case,  deassign 
the  processor  before  listing  the  queue.  Refer  to  Section  12.4  for  information  on 
related  queue  management  functions. 
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12.3.3    Holding,  Releasing,  and  Deleting  FTS  User  Jobs 

Tse  the  following  QUE  command  syntax  to  hold,  release,  or  delete  FTS  user 
jobs  on  the  queue: 

MCH^QVK  fEST-.entry-numher/suitch 
where 


cntry-numbvr  is  the  number  assigned  to  the  queue  entry  by  the  queue  man- 
ager. The  entry  number  is  obtained  bv  listing  the  contents  of 
FTSQUE  (see  Section  12.3.2). 

^^i'it(^h  is  one  of  the  following  switch  options: 

HO        holds  the  specified  job 

REL      releases  the  specified  job  from  the  hold  state 

DEL     deletes  the  specified  job 

Ordinarily,  you  do  not  delete  or  hold  jobs.  FTS  users  can  delete  their  own 
jobs.  You  need  to  use  these  commands  only  in  special  situations  (for  example, 
when  you  want  to  delay  a  job  that  is  about  to  begin). 

Example: 


MCR    QuE       £n 


DEL 


This  command  deletes  the  job  with  entry  number  857  from  the  queue. 

12.4    Related  Queue  Management  Functions 

In  addition  to  using  QUE  for  queue  management,  you  should  periodically 
perform  other  related  queue  management  functions.  These  functions  include: 

•  Purging  the  FTS  system  log  file  (FTSSYS.LOG)  and  the  FAL  svstem  log 
file  (FAL.LOG)  ' 

•  Listing  the  contents  of  FTSQUE  and  of  FTS  jobs 

•  Listing  and  purging  the  user  request  block  (URB)  files 

The  following  sections  describe  procedures  for  performing  these  functions. 

NOTE 

FTS  will  retry  requested  file  operations  if  they  fail  due  to  net- 
work problems.  After  a  number  of  unsuccessful  retries  (default 
=  5),  the  FTS  job  will  be  put  into  the  hold  state  in  FTSQUE. 
The  user  must  decide  whether  to  release  the  job  for  one  more 
retry  or  to  delete  (abort)  it. 
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12.4.1    Purging  FTSSYS.LOG  and  FAL.LOG 

Periodicallv.  vou  should  purge  the  FTS  system  log  file  (FTSSYS.LOG)  and 
the  FAL  system  log  file  (FAL.LOG).  FTSSYS.LOG  contains  a  record  of  every 
job  FTS  has  received,  along  with  coded  status  information,  time  of  receipt, 
and  time  of  completion.  The  file  is  useful  for  statistical  purposes.  FAL.LOG 
records  network  file  transfer  information  for  each  file  copied  over  the  network. 

FTSDEQ  automatically  deletes  I'RB  file  entries  as  jobs  complete.  However,  it 
does  not  delete  FTS  system  log  file  entries.  Use  the  Peripheral  Interchange 
Program  (PIP)  to  purge  these  files  when  necessary.  (See  the 
RSX-llM/M-PLrS  I'tilities  Manual  for  more  information.)  The  following 
PIP  command  displays  the  FTS  system  log  file: 

■>PIP    T  I  :  =  [  1  .aiFTSSVS.LOG 


Refer  to  the  DECnet-RSX  Guide  to  I'ser  L'tilities  for  a  description  of  the 
system  log  file  display. 

During  network  generation,  you  can  choose  to  create  the  system  log  file  in 
UFD  [1,4]  with  no  file  protection.  Optionally,  log  entries  are  copied  to  a  log  file 
in  the  UFD  of  the  user  who  queued  the  request.  The  user  is  expected  to 
maintain  this  file. 

12.4.2    Listing  FTSQUE  and  FTS  Jobs 

Periodically,  or  when  necessary,  list  the  contents  of  FTSQUE  and  of  FTS 
jobs.  The  following  command  lists  the  contents  of  FTSQUE: 

fiery  •■CUE    f^TSOUE  :  /LI  :  P 


The  system  displays: 


*♦  PRINT  QUEUES  ♦♦ 
FTSQUE  =  FTSDEQ 
C  1  .1  ]     223771  ENTryY:857 

1  DBO:  [  1  .aiFTSaiGG.urvB  ?  1 


PRINT  AFTER  2-FEB-83  11:37 
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The  FTSQUE  contains  one  job.  number  223771.  Note  that  FTSDEQ  is  the 
processor  for  FrSQl'K.  This  field  appears  only  when  the  processor  has  been 
assigned  to  the  queue.  If  this  field  does  not  appear,  the  processor  is  deas- 
signed,  but  there  can  still  be  entries  in  the  queue.  The  job  was  originally 
queued  from  the  I'lC  [4.166].  After  it  failed,  the  job  was  requeued  by  the 
PTSDEQ  task  from  VIC  [1,1].  The  queue  manager  entry  number  is  8o7.  The 
job  is  to  be  printed  (in  this  case  retried)  at  11:37. 

Note  the  format  of  the  I'RB  file  specification: 

deL'icc:[ufd]FTSnnnnnn.rHH\\\ 

where 


nnnnnn      is  the  user's  current  L'lC  (with  leading  zeroes  suppressed). 

•v.v  is  the  request  number.  If  multiple  jobs  are  queued  from  a  single 

riC.  this  number  is  greater  than  1. 

If,  after  inspecting  the  FTS  queue,  you  want  more  information  on  a  user's  job 
on  the  queue,  type: 


.>SET     .UlC  =  [u.s. 

>  ^  T  S      .  !_  I 


The  .system  displays: 


FTS  USER  rvEOUEST  LISTING 

223553   TLry/50  /IM/LO 

Queued  2  -  F  E  B -  8  3  11:^5 

Source  t^ile  --  DBO  :  [  a  ,  1  22  ]  NODES  .  5  VS  5  a 
Desiinatior.  File  --  K  V  Z  :  :  [  U  .  1  3  1  ]  NODES  .  S  VS 

223573   TLR/50  /  IM/LO 

0  M  e  M  e  d  2  - F  E  B -  8  3  11:^5 

Source  File  --  DBO  :  [  ^^  .  1  22  ]  NODF  I  L  .  MAC  ;  1  0 
Oest  mat  1  or,  Fiie  --  :;  VZ  :  :  [  ^  .  1  3  1  ]  NODE  I  L  .  MAC 

223507   TLR/50  /IM/LO 

Queued  2  -  F  E  B -  8  3  11:^5 

Source  File  --  DBO : C ^  .  1 22 ] PRMF I L . MAC ; 1 
Destination  File  --  KYZ :  : C a  .  1  3 1 ] PRMF I L . MAC 


2-FEB-83  11:^5 


Retried  0  times 


Retried  0    t  i  tn  e  5 


Retried  0  times 


The  job  numbers  at  the  beginning  of  each  entry  are  the  only  cross-reference 
you  have  to  the  .system  queue  list.  For  more  information  on  the  FTS  /LI 
switch,  see  the  DF.Cnct-RSX  (tuide  to  L'scr  rtilities. 
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12.4.3    Listing  and  Purging  URB  Fiies 

Periodically,  or  when  necessary,  list  and  purge  the  URB  tiles.  The  following 
PIP  command  produces  a  display  of  the  URB  directory': 


>Pip   c  1  .4]»  .urvB  ;»/L  I 


If  you  have  deleted  a  job  with  QUE,  you  must  also  delete  its  associated  I'RB 
file  or  files.  QUE  does  not  do  this  automatically.  However,  when  an  FTS  user 
deletes  a  job.  :t  also  is  deleted  automatically  from  its  URB  file. 
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Chapter  13 

Trace  Interpreter  Task  (TRi) 


The  trace  interpreter  task  (THI)  is  part  of  the  trace  taciiity  provided  lor 
RSX-1 1  PSI  users.  This  faeiUty  enables  you  to  diagnose  software  problems  on 
a  PSI  line  connected  to  a  device.  The  facility  traces  message  frames  passing,' 
between  the  X.25  level  2  protocol  and  the  device  driver  and  copies  the  traced 
frames  to  a  disk  file.  The  contents  of  this  file  can  then  be  analyzed  and 
printed. 

Use  NCP  TRACK  commands  to  control  the  tracing  of  frames  and  to  create  the 
file  (see  the  CLKAH  TRACT.  SET  TRACT:,  and  SHOW  TRACK  commands 
in  Chapter  6).  Then  use  TRI  to  analyze  the  contents  of  the  trace  disk  file. 


13.1    Invoking  TRI 


There  are  three  methods  of  invoking  TRI: 

1.  MCry    'RI 

TRI  then  prompts 

Try  I 

Enter  your  TRI  command  immediately  following  the  prompt.  If  the  com- 
mand executes,  the  utility  prompt  is  displayed  on  the  next  line.  If  the 
command  is  unsuccessful,  an  error  message  is  displayed  on  the  next  line 
indicating  the  reason  for  the  error  followed  by  the  utility  prompt. 

2.  MCR  :TRI  cnmmcmd 

where  command  is  any  valid  TRI  command.  With  this  method,  you  return 
•to  MCR  after  the  TRI  command  is  executed. 

3.  MCR>TPI   ^vnmmand-fdr 

where  command-file  is  the  name  of  an  indirect  command  file  containing 
TRI  commands.  You  can  nest  command  files. 
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13.2    Exiting  TRI 


To  exit  THI,  enter  Ctrlz  or 


13.3   TRI  Command  >Format 


The  I'KI  (.ommand  line  has  the  loliowing  tormat: 

[<nitfilc[/snitchcs]   ]{infilv[/su  itches]] 

where 

outfilc  is  the  Hstin^  tile.  If  no\  speeit'ied.  this  defaults  to  the  input  file 
name  with  file  type  .LST. 

infile  is  the  name  of  the  file  containing  the  tracing  data.  If  this  name  is 

not  si)ecified.  this  file  detaults  to  LB:i;.6]PSrrHA('K.SYS. 

snitches  are  the  options  available  tor  controlling  the  form  and  content  of 
the  listing  produced  by  THI.  Any  compatible  combination  of  the 
switches  shown  in  Table  l.'V  1  can  be  specified  on  either  the  input 
file  or  the  output  file. 

Table  13-1:    Trace  Interpreter  Switches 


Switch 

Meaning 

/SP 

Spodl  the  output  file 

/-SP 

Do  not  spool  the  output  file 

/OC  * 

Output  user  data  in  octal 

/AS  • 

Output  user  data  in  ASCII 

/IN 

Interpret  trace  data 

/-IN 

Do  not  interpret  trace  data 

nA:n 

Output  trace  data  for  system   line  n 

onlv 

/i'H:n  Output  trace  data  tor  channel  number 

n  onlv 


Comments 

Delault  switch.  (Output  is  spooled 
unless  /   SP  is  specified,  i 

Cannot  be  specified  with  /-IN. 

Cannot  be  specified  with  /IN. 

Detault  switch.  (Data  is  interjjreted 
unless  /IN  specified.) 

Only  SP  or  /  SP  can  be  specified 
with  this  switch. 

The  n  is  octal.  If  you  w^.u  to  specify 
a  decimal  number,  use  n.  instead. 
The  default  for  n  is  0.  Cannot  be 
specified  with  /  -IN. 

The  n  is  octal.  If  you  want  to  specify 
a  decimal  number  use  n  instead.  The 
default  for  n  is  0.  Cannot  be  specified 
with      IN. 


• 


If  you  specify  both  /OC  and   AS.  trace  data  is  printed  in  octal  bytes  with  ti     correspond- 
injj  ASCII  characters  underneath. 
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Examples: 


MCry    TRI    =/OC/AS 


This  command  uses  the  /OC  and  /AS  switches  to  output  user  data  in  octal  and 
ASCII  characters. 

MCR    TRI     =/LI:l/OC 

This  command  uses  the  ,/OC  switch  to  output  octal  user  data  for  system  line  1 
onlv. 


13.4   Contents  of  Trace  Output 

TRI  reads  the  trace  file  created  hy  the  tracing  facility  and  lists  the  following 
information  (depending  upon  the  frame  type)  for  each  traced  frame: 

Any  error  status  from  the  CCB 

The  system  line  numher 

The  direction  of  transfer  (Rx  or  Tx) 

The  frame  address  byte 

Setting  of  the  P/F  bit 

N(S)  and/or  N(R)  numbers 

The  frame  type  as  text  (for  example.  SABM) 

The  logical  channel  identifier 

Settings  of  the  Q.  D.  and  M  bits 

The  packet  type  as  text  (for  example.  Call  Req.) 

P(S)  and/or  P(R)  numbers 

Cause  and  diagnostic  fields 

The  first  few  bvtes  of  user  data 


13.5   TRI  Error  Messages 


TRI  prints  an  error  message  on  your  terminal  when  it  detects  an  operating 
error.  All  TRI  error  messages  are  listed  in  Chapter  14. 
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^^TIV 


t!  >: 


Tliis  seetiaii  mmmmiMm  all  mw  awetigw  for  tim  fi^owing  tools  and 
utOitte: 


NTO 

NUKrr 

NTL 
VHP 


Chapter  14 

Utility  Error  IVIessages 


This  chapter  lists  the  error  messages  sent  by  the  following  utility  programs: 

•  Console  carrier  requester  (CCR) 

•  Configuration  File  Editor  iCVK) 

•  Host  Task  Loader  (HLD) 

•  Network  Control  F^rogram  (NCP) 

•  Network  Dump  Analyzer  (NDA) 

•  Network  Display  Program  (NTD) 

•  Network  initializer  (NTINIT) 

•  Network  loader  (NTD 

•  Trace  interpreter  task  (TRI) 

•  Virtual  Network  Processor  (VNP) 

You  would  not  be  surprised  to  receive  a  CFE  error  message  if  you  had  just 
invoked  a  CFE  command.  However.  CFE.  NCP.  and  VNP  use'the  NTINIT 
and  NTL  utilities  to  process  your  commands.  Therefore,  an  error  could  occur 
in  one  of  those  utilities  instead  of  in  the  one  that  you  invoked.  You  will  receive 
an  error  message  from  the  utility  in  which  the  error  occurred.  Each  error 
message  has  a  prefix  that  identifies  the  utility  that  sent  it. 

In  this  chapter,  error  messages  are  arranged  in  alphabetical  order  by  utility 
and  message  text.  Variable  fields  within  messages  are  ignored  for  purposes  of 
alphabetization. 
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CCR 

Error  Messages 


14.1    CCR  Error  Messages 


CCR  —  Component  In  wrong  state,  xxx 

The  speeitied  component  was  not  in  the  correct  state  to  proceed  with  the 
operation  of  console  carrier  l.v.x.v      circuit  or  system). 

CCR  ~  File  I/O  error,  xxx 

An  I/O  error  occurred  while  trying  to  read  the  specified  file  (.v.v.v      seiond- 
ary  loader  or  load  file). 

CCR  —  File  open  error,  xxx 

CCR  was  unahle  to  open  the  specified  file  (.v.v.v      secondar\-  loader  or  load 
file). 

CCR  —  Invalid  file  contents,  xxx 

The  contents  of  the  specifie  '  tile  are  not  in  the  required  format  (.v.v.v  = 
secondary  loader  or  load  file). 

CCR  —  Invalid  identification  format,  xxx 

The  format  for  the  specified  parameter  is  invalid  (.v.v.v       node,  service 
circuit,  hardware  address,  or  service  password). 

CCR  —  Line  communication  error 

The  operation  failed  due  to  a  communication  error  on  the  line. 
CCR  —  Line  protocol  error 

The  operation  failed  due  to  a  protocol  error. 
CCR  —  Management  programming  error 

An  internal  programming  error  has  been  detected. 
CCR  —  Message  format  error 

The  format  of  a  received  protocol  message  was  invalid. 
CCR  —  Parameter  missing,  xxx 

The  required  parameter  was  not  defined  in  the  v  unmand  line  anrl  the 

rlOWP.     line    'f^'i    '^'^tn    Kocn    l  vv>-  »->r\r<n      cn»"^'ic>n   c'tt-fiiit       "^  ^  »*.'-(i,- n  rn    'iz-irlrncc      rtr 


•iviviv.*.     pti.T.-i »»  Ki  v.*  /  . 
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CCR 

Error  Messages 


CCR  —  Privilege  violation 

The  user  dees  not  have  sufficient  privileges  to  run  CCR. 

CCR  —  Protocol/address  pair  in  use 

The  protocol/address  pair  used  to  communicate  with  the  target  system  is 
already  in  use. 

CCR  ~  Remote  console  already  in  use 

Another  user  on  another  node  has  already  reserved  the  remote  console  on 
the  target  system. 


• 
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CFE 


Error  Messages 


14.2   CFE  Error  Messages 


All  CFE  error  messages  documented  in  this  chapter  are  classified  according  to 
severity  and  cause.  Both  classifications  are  described  below  and  are  noted  at 
the  beginning  of  each  error  description. 

Severity  classifications 


Informational 

Warning 
Error 

Severe  Error 


There  is  a  minor  problem,  but  it  does  not  affect  the  task's 
exit  status. 

Minor  error.  Processing  continues. 

Major  error.  The  command  was  accepted,  but  failed  to  exe- 
cute completely.  The  system  waits  for  a  new  command. 

The  command  was  not  accepted.  Processing  stops  and  con- 
trol returns  to  the  monitor. 


Cause  classifications 

CETAB  Parse     These  errors  occur  during  the  parsing  of  CETAB.MAC.  They 

usually  occur  when  someone  has  edited  CETAB  using  a  texi 
editor.  Restore  CETAB  to  its  original  content. 


CETAB 


Configuration 


Command 


General 


These  errors  are  generated  in  response  to  valid  commands. 
They  usually  occur  when  someone  has  edited  CETAB  using  a 
text  editor.  Restore  CETAB  to  its  original  content. 

These  errors  are  generated  by  valid  commands  that  refer  to 
features  or  components  that  are  not  in  the  CETAB  file  being 
edited.  Check  the  CETAB  file  and  enter  the  correct  com- 
mand. 

These  errors  usually  are  caused  by  a  mistyped  command  or 
by  an  incorrect  or  inapplicable  parameter.  Correct  the  com- 
mand and  reenter  it. 

These  errors  usually  indicate  a  problem  with  the  CFE  instal- 
lation or  with  the  HELP  or  CETAB  files.  The  cause  is  proba- 
bly an  invalid  UIC  or  something  similar. 
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CFE 

Error  Messages 


CFE  —  Access  verification  not  supported 

(Error/Configuration)  You  do  not  have  access  verification  supported  in 
your  system,  so  you  cannot  change  the  verification  state. 

CFE  —  Bad  port  value 

(Severe  Error/CETAB  Parse)  The  numher  of  ports  on  the  PSN$DF  macro 
is  out  of  range  or  contains  nonnumeric  characters. 

CFE  —  Bad  transport  subaddress  value 

(Severe  Error/CETAB  Parse)  The  transport  subaddress  values  on  the 
PSN$DF  macro  are  out  of  range  or  contain  invaHd  characters. 

CFE  —  Buffer  allocation  failure 

(Error/Command)  CFE  tried  to  allocate  an  internal  buffer  to  complete  the 
command  but  failed.  If  you  must  make  a  new  entry  in  CETAB,  then 
remove  CFE  and  reinstall  it  with  an  increment. 

CFE  —  Call  mask  and  call  value  are  different  lengths 

(Error/Command)  The  call  mask  and  call  value  of  a  destination  must  be 
of  the  same  length. 

CFE  —  Circuit  not  in  configuration 

(Error/Configuration)  The  circuit  in  the  command  is  not  in  the  data  base. 
CFE  —  Command  line  error 

(Error/Command)  The  command  has  a  bad  character  or  equivalent. 

CFE  —  Consistency  error 

(Severe  Error/General)  There  is  an  internal  consistency  error  in  CFE. 
Please  contact  your  software  specialist  to  determine  the  cause  of  this  error. 

CFE  —  Destination  not  in  configuration 

(Error/Configuration)  The  destination  in  the  command  is  not  in  the  data 
base. 
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CFE 

Error  Messages 


CFE  —  DTE  not  in  configuration 

(Error/Configuration)  The  DTE  in  the  command  is  not  in  the  data  base. 

CFE  —  DTE  number  ignored  for  incoming  SVC:  DLM-u.f 

(Warning/Command)  The  DTE  parameter  is  not  applicable  to  incoming 
SVCs  and  is  ignored.  The  remainder  of  the  command  will  be  processed. 

CFE  —  DTE  number  missing  from  outgoing  SVC:  DLM-u.f 

(Severe  Error/CETAB  Parse)  The  DTE  number  is  required  for  outgoing 
SVCs.  Reenter  the  command  with  the  DTE  number. 

CFE  —  DTE  with  DLi\A  circuits  not  purged:  DTE-address 

(Error/Command)  The  indicated  DTE  was  not  purged  because  some  of  its 
circuits  are  data-link-mapping  circuits.  Data-link-mapping  circuits  may 
not  be  purged. 

CFE  —  Dupiicate  PSN$DF  in  CETAB 

(Severe  Error/CETAB  Parse)  There  is  more  than  one  PSNSDF  macro  in 
the  CETAB.MAC  file.  Remove  one  of  the  PSN$DF  macros. 

CFE  —  Error  in  cail  masic  or  caii  vaiue 

(Error/Command)  The  format  in  the  call  mask  or  call  value  in  the  com- 
mand is  invalid. 

CFE  —  Error  in  channel  list 

(Error/Command)  The  format  of  the  channel  list  in  the  command  is  in- 
valid. 

CFE  —  Error  In  channel  number 

(Severe  Error/CETAB  Parse)  The  channel  number  on  a  CHN$DF  macro 
is  out  of  range  or  contains  nonnumeric  characters. 

CFE  —  Error  In  controller  number 

(Severe  Error/CETAB  Parse)  The  controller  number  on  an  SLTSDF 
macro  is  invalid. 

CFE  —  Error  In  DDM  name 

(Severe  Error/CETAB  Parse)  The  DDM  name  on  an  SLTSDF  macro  is  too 
long. 
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Error  Messages 


• 


CFE  —  Error  in  DLC  name 

(Severe  Error/CETAB  Parse)  The  DLC  name  on  an  SLT$DF  macro  is  too 
long. 

CFE  —  Error  In  DTE  address 

(Severe  Error/CETAB  Parse)  The  DTE  address  field  on  an  SVC$DF 
macro  is  out  of  range. 

CFE  —  Error  In  flags 

(Severe  Error/CETAB  Parse)  The  fiags  field  on  a  CUG$DF,  PSN$DF, 
PVC$DF,  SLT$DF,  or  SVC$DF  macro  is  unrecognized  or  invalid. 

CFE  —  Error  In  line  ID 

(Severe  Error/CETAB  Parse)  The  line  identification  on  a  DTE$DF  macro 
is  of  an  invalid  format. 

CFE  —  Error  In  line  type 

(Severe  Error/CETAB  Parse)  The  line  type  on  an  SLTSDF  macro  is  unrec- 
ognized. 

CFE  —  Error  in  LLC  name 

(Severe  Error/CETAB  Parse)  The  LLC  name  on  an  SLTSDF  macro  is  too 
long. 

CFE  —  Error  In  maximum  circuits 

(Severe  Error/CETAB  Parse)  The  maximum  circuits  value  on  an  X2P$DF 
macro  is  out  of  range  or  has  an  invalid  format. 

CFE  —  Error  in  maximum  lecalls 

(Severe  Error/CETAB  Parse)  The  maximum  recall  field  on  an  SVC$DF 
macro  is  out  of  range. 

CFE  —  Error  In  network  name 

(Severe  Error/CETAB  Parse)  The  network  name  on  a  DTE$DF  or 
PSNSDF  inacro  is  too  long  or  contains  invalid  characters. 

CFE  —  Error  In  opening  file 

(Severe  Error/General)  CFE  could  not  open  the  specified  CETAB  source 
file.  Make  sure  that  the  file  is  where  you  specified,  that  the  file  is  not 
locked,  and  that  you  have  write  privileges  to  the  file. 
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CFE  —  Error  In  owner 

(Severe  F^rror/CETAB  Parse)  The  owner  process  field  on  an  SLTSDF 
macro  is  unrecognized. 

CFE  —  Error  in  packet  size 

(Severe  Error/CETAB  Parse)  The  packet  size  field  on  an  SVC$DF  or 
X2P$DF  macro  is  out  of  range. 

CFE  —  Error  in  recall  timer 

(Severe  Error/CETAB  Parse)  The  recall  timer  value  field  on  an  SVCSDF 
macro  is  out  of  range. 

CFE  ~  Error  in  SVC  name 

(Severe  Error/CETAB  Parse)  The  SVC  circuit  ID  on  an  SVC$DF  macro 
has  an  invalid  format. 

CFE  —  Error  In  unit  number 

(Severe  Error/CETAB  Parse)  The  unit  number  on  an  SLTSDF  is  invalid. 

CFE  —  Error  in  window  size 

(Severe  Error/CETAB  Parse)  The  window  size  on  an  SVC$DF  or  X2P$DF 
macro  is  out  of  range. 

CFE  —  Error  writing  file 

(Severe  Error/General)  CFE  was  unable  to  write  a  record  to  the  output 
file:  therefore  the  CETAB  source  file  was  not  updated.  Check  to  make  sure 
that  the  disk  is  not  full. 

CFE  —  Executor  node  not  allowed 

(Error/Command)  An  attempt  has  been  made  to  define  the  executor  node 
as  a  remote  node. 

CFE  —  Executor  node  not  allowed  with  command 

(Error/Command)  The  command  parameters  speciiied  in  the  command 
are  not  permitted  on  the  executor  node. 

CFE  ~  Group  not  in  configuration 

(Error/Configuration)  The  closed  user  group  in  the  command  is  not  in  the 
data  base. 
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CFE  —  Illegal  baud  rate 

(^  ror/C  cmmand)  The  baud  rate  specified  in  ine  command  is  out  ot  range 
or  no^  in  the  table  of  valid  baud  rates.  Reenter  the  command  with  a  legal 
baud  rate. 

CFE  —  Illegal  call  mask 

(Severe  Error/CETAB  Parse)  The  call  mask  on  a  DSCSDF  macro  is  too 
long  or  contains  invalid  characters. 

CFE  —  Illegal  call  value 

(Severe  Error/CFITAB  Parse)  The  call  value  on  a  DSCSDF  macro  is  too 
long  or  contains  invalid  characters. 

CFE  —  Illegal  circuit  type 

(Error/Command)  The  circuit  type  in  the  command  is  illegal  for  the  re- 
quested operation.  For  example,  it  is  illegal  to  purge  a  DDCMP  circuit. 

CFE  —  Illegal  command 

(Error/Command)  The  command  you  gave  to  (TE  is  incorrect. 

CFE  —  Illegal  CUG  name 

(Severe  P>ror/CETAB  Parse)  The  user  group  name  on  a  Cl'G$DF  or 
DSASDF  macro  is  too  long  or  contains  invalid  characters. 

CFE  —  Illegal  destination  address 

(Severe  Error/CETAB  Parse)  The  destination  address  on  a  DSA$DF 
macro  is  not  a  valid  DTE  address. 

CFE  —  Illegal  destination  name 

(Severe  Error/CETAo  Parse)  The  destination  name  on  a  DST$DF  macro 
is  too  long  or  contains  invalid  characters. 

CFE  —  Illegal  destination  pri^Hty 

(Severe  Error/CETAB  Parse)  The  list  insertion  priority  on  a  DSTSDF 
macro  is  out  of  range  or  contains  nonnumeric  characters. 

CFE  —  lllegaj  destination  type 

(Severe  Error/CETAB  Parse)  The  destination  type  on  a  DSTSDF  macro  is 
not  legal  for  PSI. 
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CFE  ~  Illegal  device  priority 

(Error/Command)  The  device  priority  specified  in  the  command  is  out  of 
range. 

CFE  —  Illegal  DTE  name 

(Severe  Error/CETAB  Parse)  The  DTE  name  on  a  RDT$DF  macro  is  too 
long  or  contains  invalid  characters. 

CFE  —  Illegal  executor  node  address 

(Error/Command)  An  attempt  was  made  to  define  the  executor  node  ad- 
dress to  greater  than  the  maximum  address  for  the  network. 

CFE  —  Illegal  group  number 

(Severe  Error/CETAB  Parse)  The  group  number  on  a  CUGSDF  macro  is 
out  of  range  or  contains  nonnumeric  characters. 

CFE  —  Illegal  logical  channel  number 

(Severe  Error/CETAB  Parse)  The  logical  channel  number  on  a  PVCSDF 
macio  is  out  of  range  or  contains  nonnumeric  characters. 

CFE  —  Illegal  maximum  data  size 

(Severe  Error/CETAB  Parse)  The  maximum  data  size  on  a  PVCSDF 
macro  is  out  of  range  or  contains  nonnumeric  characters. 

CFE  —  Illegal  object  number 

(Seveiv.  Error/CETAB  Parse)  The  object  number  on  a  DST$DF  macro  is 
out  of  range  or  contains  nonnumeric  characters. 

CFE  ->  Illegal  owner  process 

(Severe  Error/CETAB  Parse)  The  owner  process  identification  field  on  a 
PVCSDF  macro  is  not  a  recognized  owner. 

CFE  —  Illegal  PVC  name 

(Severe  Error/CETAB  Parse)  The  circuit  identification  on  a  PVCSDF 
macro  is  too  long  or  contains  invalid  characters. 

CFE  ~  Illegal  state 

(Severe  Error/CETAB  Parse)  The  state  on  a  PVCSDF  macro  is  not  a 
recognized  state. 
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CFE  —  Illegal  subaddress  high  range 

(Severe  Error/CETAB  Parse)  The  indicated  subaddress  on  a  DSA$DF 
macro  is  out  of  range  or  contains  nonnumeric  characters. 

CFE  —  Illegal  subaddress  low  range 

(Severe  Error/CETAB  Parse)  The  indicated  subaddress  on  a  DSASDF 
macro  is  out  of  range  or  cor<:ains  nonnumeric  characters. 

CFE  —  Illegal  task  name 

(Severe  Error/CETAB  Parse)  The  task  name  on  a  DST$DF  macro  is  too 
long  or  contains  invalid  characters.  This  message  is  also  generated  if  a 
task  name  is  included  and  the  destination  object  number  is  not  zero. 

CFE  —  Illegal  window  size 

(Severe  Error/CETAB  Parse)  The  window  size  on  a  PVCSDF  macro  is  out 
of  range  or  contains  nonnumeric  characters. 

CFE  —  Insufficient  buffer  space 

(Severe  Error/General)  CFE  was  not  built  with  enough  buffer  space  to 
accommodate  the  CETAB  source  file  information.  Remove  CI '5  and  rein- 
stall it  with  an  increment. 

CFE  —  Invalid  block  size 

(Severe  Error/CETAB  Parse)  The  block  size  on  an  X2P$DF  macro  is  out 
of  range  or  of  an  invalid  format. 

CFE  —  Invalid  call  timer  value 

(Severe  Error/CETAB  Parse)  The  call  timer  field  on  the  X3P$DF  macro  is 
out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  circuit  identification 

(Error/Command)  The  format  of  the  circuit  ID  in  the  command  is  invalid. 

CFE  —  Invalid  clear  timer  value 

(Severe  Error/CETAB  Parse)  The  clear  timer  field  on  the  X3P$DF  macro 
is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  counter  timer  value 

(Severe  Error/CETAB  Parse)  The  counter  timer  value  on  a  DTESDF, 
PVCSDF,  or  SLT$DF  macro  is  out  of  range  or  contains  invalid  characters. 
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CFE  —  Invalid  default  block  size 

(Severe  Error/CETAB  Parse)  The  default  block  size  on  the  X3P$DF 
macro  is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  default  window  size 

(Severe   Error/CETAB    Parse)    The   default   window   size   tield   on   the 
X3P$DF  macro  is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  destination  sequence 

(Error/CETAB)  An  invalid  destination  sequence  has  been  detected.  This 
usually  indicates  a  corrupt  CETAB.MAC  file. 

CFE  ~  Invalid  DTE  address 

(Severe  Error/CETAB  Parse)  The  DTE  address  on  a  DTESDF  or  RDT$DF 
macro  is  too  long  or  contains  invalid  characters. 

CFE  —  invalid  DTE  state 

(Severe  Error/CETAB  Parse)  The  state  on  a  DTE$DF  macro  is  not  a 
recognized  DTE  state. 

CFE  —  Invalid  hash  table  size 

(Severe  Error/CETAB  Parse)  The  hash  table  size  on  a  DTESDF  macro  is 
out  of  range,  is  not  a  power  of  2,  or  contains  invalid  characters. 

CFE  —  Invalid  holdback  timer  value 

(Severe  Error/CETAB  Parse)  The  holdback  timer  value  on  an  X2P$DF 
macro  is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  line  identification 

Two  error  conditions  can  display  this  message: 

•  (Severe  Error/CETAB  Parse)  CFE  found  an  X2P$DF  macro  containing 
an  error  in  the  line  identification.  This  error  occurs  during  the  initial 
scan  of  the  CETAB  file  when  CFE  is  invoked. 

•  (Error/Command)  The  line  ID  specified  in  the  command  is  incorrect. 

CFE  —  Invalid  maximum  block  size 

(Severe  Error/CETAB  Parse)  The  default  block  size  on  the  X3P$DF 
macro  is  out  of  range  or  is  of  an  invalid  format. 
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CFE  —  Invalid  maximum  clears  value 

(Severe  Error/CEITAB  Parse)  The  maximum  clears  field  on  the  X.'iP$DF 
macro  is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  maximum  resets  value 

(Severe  Error/CETAB  Parse)  The  maximum  resets  field  on  the  X3P$DF 
macro  is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  maximum  restarts  value 

(Severe  Error/CETAB  Parse)  The  maximum  restarts  field  on  the  X3P$DF 
macro  is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  maximum  window  size 

(Severe  Error/CETAB  Parse)  The  maximum  window  size  field  on  the 
X3P$DF  macro  is  out  of  range  or  is  of  an  invalid  format. 

CFE  — -  Invalid  multicopy  task  name 

(Error/Command)  The  task  name  of  a  multicopy  object  must  be  of  the 
format  .va:x$$$,  where  xxx  is  1  to  3  alphanumeric  characters.  This  message 
is  generated  when  an  attempt  is  made  to  define  a  multicopy  object  with- 
out a  multicopy  name  or  a  single  copy  object  with  a  multicopy  name. 

CFE  —  Invalid  number 

(Error/Command)  The  command  has  a  number  out  of  range. 
CFE  —  Invalid  process  Identification 

(Error/Command)  The  process  name  specified  in  the  command  is  too  long. 

CFE  —  Invalid  reset  timer  value 

(Severe  Error/CETAB  Parse)  The  reset  timer  field  on  the  X3P$DF  macro 
is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  restart  timer  value 

(Severe  Error/CETAB  Parse)  The  restart  timer  field  on  the  X3P$DF 
macro  is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  retransmit  count 

(Severe  Error/CETAB  Parse)  The  retransmit  count  on  an  X2P$DF  macro 
is  out  of  range  or  is  of  an  invalid  format. 
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CFE  —  Invalid  retransmit  timer  value 

(Severe  Error/CETAB  Parse)  The  retransmit  timer  value  on  an  X2P$DF 
macro  is  out  of  range  or  is  of  an  invalid  format. 

CFE  —  Invalid  wildcard  syntax 

(Error/Command)  The  wildcard  line  or  circuit  ID  in  the  command  is  of  an 
invalid  format. 

CFE  —  Line  not  in  configuration 

(Error/Configuration)  The  line  specified  in  the  command  is  not  in  the 
CETAB  source  file. 

CFE  —  Logging  monitor  not  supported 

(Error/Configuration)  The  logging  monitor  is  not  supported  in  your  system 
configuration. 

CFE  —  Missing  LLC$DF  for  NW 

(Error/CETAB)  The  LLCSDF  macro  for  NVV  is  missing  from  the  data 
base.  This  usually  indicates  a  corrupt  CETAB. MAC  file. 

CFE  —  Missing  parameter:  parameter 

(Error/Command)  The  indicated  parameter  is  required  for  the  type  of 
operation  requested  and  is  missing  from  the  command.  Correct  the  com- 
mand and  reenter  it. 

CFE  —  Missing  X2P$DF  for  line  line-id 

(Error/CETAB)  There  is  no  X2P$DF  macro  for  the  indicated  line.  This 
usually  indicates  a  corrupt  CETAB. MAC  file. 

CFE  —  No  buffer  definition 

(Error/CETAB)  The  CETAB  source  file  does  not  contain  a  Bl;F$DF 
macro  defining  your  buffers. 

CFE  ~  No  HELP  available 

(Informational/General)  CFE  could  not  find  the  help  file. 

CFE  —  No  node  definition 

(Error/CETAB)  The  CETAB  source  file  does  not  contain  a  NOD$DF 
macro  defining  the  local  node. 

CFE  ~  No  partition  definition 

(Error/CETAB)  The  CETAB  source  file  does  not  contain  a  PARSDF 
macro  defining  the  network  pool. 
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CFE  —  No  PSI  support  In  system 

(Elrror/Configuration)  The  CE^TAB  being  processed  does  not  include  sup- 
port for  PSI. 

CFE  —  No  routing  definition 

(Error/CETAB)  The  CETAB  source  file  does  not  contain  a  ROl'.SDF 
macro  defining  the  routing  parameters. 

CFE  —  No  station  template  for  line-id 

(Error/CETAB)  There  are  no  station  templates  for  the  indicated  line.  This 
usually  indicates  a  corrupt  CFITAB.MAC  file. 

CFE  —  No  unit  CSR  on  this  line 

(Flrror/Command)  An  attempt  was  made  to  change  the  unit  CSR  for  a  line 
that  does  not  have  a  unit  CSR.  This  part  of  the  command  was  ignored. 

CFE  —  No  XPT  features  macro 

(Error/CETAB)  The  CETAB  source  file  does  not  contain  an  FEA$DF 
macro  defining  the  XFT  features.  You  will  not  })e  able  to  modify  any  of 
the  states  defined  by  this  macro. 

CFE  —  No  XPT  process  macro 

(Error/CETAB)  The  CETAB  source  file  does  not  contain  an  LL(\SI)F 
macro  defining  the  XPT  process. 

CFE  —  No  X.29  support  in  configuration 

(Error/Configuration)  The  CETAB. MAC  file  being  proce.s.sed  does  not 
contain  the  X29$DF  macro. 

CFE  —  No  X3P$DF  in  data  base 

(Error/CETAB)  The  X.SPSDF  macro  is  not  in  the  data  base.  This  usu.illv 
indicates  a  corrupt  CETAB. MAC  file. 

CFE  —  Node  address  already  in  use 

(Error/Command)  The  address  you  want  to  give  this  node  is  aireadv  in 
use. 

CFE  —  Node  name  already  in  use 

(E  Tor/Command)  The  name  you  want  to  give  this  node  is  already  in  use. 
CFE  —  Node  not  in  configuration 

(Error/Configuration)  The  node  specified  in  the  command  is  not  in  the 
CETAB  source  file. 
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CFE  —  Number  of  SDBs  exceeds  number  of  CCBs 

(Warnin^iCK  TAB)  The  niaximum  number  nt  SDBs  specified  in  the 
Bl'FsDF  macro  exceeds  the  number  ol  CCBs  >|)ecitied  in  the  BCKSDF 
macro. 

CFE  —  Object  not  in  configuration 

(Krror  Configuration)  The  object  specified  in  the  command  is  not  in  the 
CK  TAB  source  file. 

CFE  —  Object  task  name  must  be  specified 

( Krror  Commandi  An  attem{)t  was  made  to  create  an  tibject  type  entry 
without  an  associated  task  name.  Reenter  the  command  with  the  task 
name  suppHed. 

CFE  —  Operation  invalid  for  line  type 

( Krror  Command)  The  retjuested  oj)eration  is  not  api)Hcable  to  the  bne 
type  indicateci  in  the  command. 

CFE  —  Parameter  applicable  to  PSI  systems  only 

(Error/Configuration)  One  or  more  of  the  parameters  in  the  command  is 
inappHcable  to  systems  without  BSI.  and  the  CKTAB  bein^  processed  is 
for  a  nonT^SI  system. 

CFE  —  Parameter  illegal  for  circuit  type 

(Error/Command)  One  or  more  of  the  parameters  in  the  command  cannot 
l)e  set  for  the  type  of  circuit  indicated. 

CFE  —  Parameter  illegal  for  wildcard  operation 

(P>ror/Command)  One  or  more  of  the  parameters  in  the  command  is  not 
allowed  for  wildcard  or  KNOWN  operations. 

CFE  —  Parameter  not  applicable 

(Error/Configuration)  One  or  more  of  the  parameters  in  the  command  is 
not  applicable  to  the  CETAB  configuration  (for  example,  routing  parame- 
ters for  an  end  node). 

CFE  —  Pool  byte  extension  less  than  minimum 
Defaulting  to  nnn. 

(Warning/Command)  The  pool  byte  extension  on  ?  ..  command  is  less 
than  the  minimum  required  for  structures  defined  in  the  CETAB.  The 
minim. m  value  nnn.  is  being  used  instead. 


14-16       DECnet-RSX  System  Manager's  Guide 


CFE 

Error  Messages 


CFE  —  Process  not  in  configuration 

(Error/Configuration)  The  process  name  specified  in  the  command  is  not 
in  the  CETAB  source  file. 

CFE  —  Routing  parameters  not  applicable 

(Error/Command)  The  routing  parameters  in  the  command  are  not  appli- 
cable to  an  end  node. 

CFE  —  Syntax  error 

(Severe  Error/CETAB  Parse)  The  indicated  macro  contains  an  invalid  or 
unrecognized  value. 

CFE  —  Task  name  not  allowed  with  object  type  zero 

(Error/Command)  An  attempt  was  made  to  force  a  single  task  to  be  a.s.so- 
ciated  with  the  general  task  connect  (type  zero).  This  part  of  the  com- 
mand was  ignored. 

CFE  —  Too  many  stations 

(Severe  Error/CETAB)  There  are  more  stations  on  a  particular  line  than 
CFE  is  prepared  to  handle.  This  message  is  followed  by  the  syntax  error 
message  and  the  entry  read  from  CETAB  that  caused  the  station  number 
overflow. 

CFE  —  Unknown  HELP  qualifier 

(Informational/General)  CFE  has  no  help  on  the  qualifier  requested. 

CFE  —  Usage  cannot  be  permanent 

(Error/Command)  The  usage  of  an  SVC  must  be  either  incoming  or  outgo- 
ing. 

CFE  —  XPT  not  allowed  to  load  line  tables  in  process  space 

(Error/Configuration)  The  command  included  an  extension  for  line  tables 
for  XPT.  Since  XPT  cannot  have  line  tables  in  process  space,  this  part  of 
the  command  was  ignored. 

CFE  ~  X25-SERVER  not  in  configuration 

(Error/Configuration)  There  is  no  support  for  the  X,25  server  modu'e  in 
the  system. 

CFE  —  X29-SERVER  not  in  configuration 

(Error/Configuration)  There  is  no  support  for  the  X.29  server  module  in 
the  svstem. 
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Some  of  the  HLD  error  messages  include  strings  that  are  replaced  with  run- 
time variables.  A  list  of  these  strings  and  the  type  of  information  they  contain 
is  shown  below. 

i-nnn.)  A  DSVV  or  lOSB  error  code  (always  negative). 

innn.)  A  network  code  (always  positive). 

node  The  name  of  the  remote  RSX   US  node. 

task  The  installed  task  name  received  from  SLD. 

filvspcc  A  copy  of  the  file  specification  from  the  HTASK$  macro.  This  is 
followed  by  (File)  to  indicate  that  HLD  found  a  match  from  the 
external  mapping  tables,  or  by  ((i-P)  to  indicate  that  the  task  was 
found  on  the  general  purpose  list,  or  by  (File.  O-P)  to  indicate  that 
both  conditions  were  satisfied. 

Variable  fields  are  ignored  in  the  alphabetization  of  error  messages  in  this 
chapter. 

HLD  —  node/task  —  Base  address  not  a  multiple  of  4K 
HLD  —  fllespec 

The  file  was  not  built  with  the  AIM  switch.  Rebuild  the  file. 

HLD  —  node/task  —  Connect  accept  failure  {-nnn.) 
HLD  —  f//espec 

The  attempt  to  accept  a  connection  from  a  remote  SLD  has  tailed.  The 
remote  node  may  have  become  unreachable. 

HLD  —  node/task  —  Disk  read  failure  (-nnn.) 
HLD  —  f//espec 

This  error  message  indicates  a  disk  error  while  reading  the  file  (initial  load 
or  checkpoint  read).  Validate  the  integrity  of  the  file  and  the  disk.  The 
second  error  message  line  may  or  may  not  appear. 

HLD  —  node/task  —  Disic  write  failure  {-nnn.) 

This  error  message  indicates  a  disk  error  while  writing  to  the  file  (check- 
point write).  Validate  the  integrity  of  the  file  and  the  disk. 

HLD  —  node/task  —  File  has  never  been  installed 

The  task  file  has  not  been  installed  (via  VMR)  into  the  RSX -US  system. 
This  error  message  appears  if  you  rebuild  the  task  file  but  neglect  to 
install  it.  Tse  VMR  to  in.stall  the  task  into  the  RSX-  US  svstem. 
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HLD  —  node/task  ^  File  has  no  task  header 
HLD  —  fllespec 

The  file  was  built  with  the  /-HD  switch.  It  is  not  a  valid  RSX-US  task 
image.  Rebuild  the  file. 

HLD  —  node/task  —  File  is  larger  than  partition 
HLD  —  f//espec 

The  initial  load  size  of  the  file  is  larger  than  the  partitiim  size  in  the 
RSX-US  system.  Either  make  the  partition  larger  or  rebuild  the  file  to 
use  a  smaller  partition  size. 

HLD  —  node/task  —  File  is  not  contiguous 
HLD  —  f/7espec 

The  file  is  not  contiguous.  Either  rebuild  the  file  or  use  PIP  to  make  the 
file  contiguous  (see  example  below). 


>PIP    /Ni.)/CO=/;/.vpr( 
■^PIP    /V/t'spcc/PU 

HLD  —  node/task  —  File  spec  parse  error 
HLD  — f//espec 

The  file  specification  for  the  file  has  an  invalid  format.  Rebuild  the  HLD 
data  base. 

HLD  —  node/task  —  G-P  tasks  may  not  be  checkpointed 
HLD  —  filespec 

A  checkpoint  operation  was  attempted  for  an  HTASK$  macro  from  the 
general  purpose  list.  Edit  and  rebuild  the  appropriate  mapping  table  to 
move  the  HTASKS  macro  from  the  general  purpose  list  into  a  node-spe- 
cific list. 

HLD  —  Invalid  connect  request  from  node-id 

A  task  attempted  to  connect  to  HLD  but  did  not  supply  a  valid  optional 
connect  data  message.  Refer  to  your  object  type  tables  within  NETACP. 
HLD  is  connected  to  by  the  object  NO.RTL  and  not  by  the  installed  task 
name.  NO.RTL  is  defined  in  the  XSSYMS  macro.  Its  object  tvpe  number 
is  18. 

HLD  —  node/task  —  Invalid  data  type  in  mailbox  {nnn.) 

A  network  data  type  was  found  in  the  mailbox  that  is  not  used  by 
HLD/SLD.  If  the  data  type  is  a  ctmnect.  NSP  has  tried  to  place  more 
connects  onto  the  mailbox  than  HLD  can  handle. 
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HLD  —  node/task  —  Label  block  read  failure  {-nnn.) 
HLD  —  filespec 

The  label  block  (TKB  information)  could  not  be  accessed  successfully. 
Rebuild  the  file. 

HLD  —  nodeltask  —  LUN  fixing  not  supported 
HLD  —  f//espec 

The  remote  SLD  was  not  built  with  the  Ll'X-fixing  module.  Either  re- 
build the  remote  SLD.  or  edit  and  rebuild  the  appropriate  mapping  table 
to  move  the  HTASK$  macro  from  general  purpose  list  into  a  node-specific 
list.  This  error  also  occurs  if  the  HTASK$  macro  is  already  in  a  node- 
specific  list  but  uses  the  LUN  control  argument. 

HLD  —  Mailbox  LUN  assignment  failure  {-nnn.) 

HLD  could  not  successfully  assign  the  network  mailbox  Ll'N  to  the  NS: 
device.  Check  to  see  if  the  local  node's  state  is  ON. 

HLD  —  node/task  •—  Mapping  file  base  address  not  zero 

This  error  is  caused  by  an  incorrect  TKB  command  file.  VA'W  the  TKB 
command  file,  add  the  /-MM  switch  to  the  output  file  specifier,  and  then 
add  or  modify  the  PAR  statement  to  read  PAR  ANY:():2(KMM).  Then  re- 
build the  file. 

HLD  —  nodeltask  —  Mapping  file  contains  a  task  header 

This  error  is  caused  by  an  incorrect  TKB  command  file.  F^dit  the  TKB 
command  file  and  add  the  /-HD  switch  to  the  output  file  specifier.  Then 
rebuild  the  file. 

HLD  —  nodeltask  —  Mapping  file  contains  garbage 

HLD  can  successfully  read  the  external  file,  but  the  file  is  internally 
inconsistent.  Rebuild  the  file. 

HLD  —  nodeltask  —  Mapping  file  is  larger  than  HLDFIL  buffer  space 

The  external  mapping  file  is  larger  than  the  buffer  space  available.  Merge 
the  external  table  into  the  internal  table.  Discontinue  use  of  the  external 
table. 

HLD  —  nodeltask  —  Mapping  file  is  not  contiguous 

The  file  is  not  contiguous.  Either  rebuild  the  file  or  use  F^IP  to  make  the 
file  contiguous  (see  example  below). 

PIP  /NV/CO  =  HLDTAB  .  T5K 
:PIP  HLDTAB. TSK/PU 
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HLD  —  nodeltask  —  Mapping  file  label  block  read  failure  {-nnn.) 

HI  could  not  read  the  tile's  label  hlvK-k  (which  contains  TKB  descriptive 
intormation).  Rebuild  the  tile. 

HLD  —  node/task  —  Mapping  file  open  failure  {-nnn.) 

HLD  could  not  open  the  tile.  Rebuild  the  file. 
HLD  —  nodeltask  —  Mapping  file  read  failure  {-nnn.) 

HLD  could  not  read  the  external  mapping  file.  Rebuild  the  file. 
HLD  —  Network  data  queue  empty 

HLD  tound  nothing  in  the  network  data  queue.  This  error  occurs  if  you 
issue  MCR  -Rl'N  HLD...  or  if  the  connection  times  out  before  HLD  can 
remove  the  connect  request  from  the  network  data  queue.  Increase  the 
connect  timeout  period. 

HLD  —  node/task  —  Network  disconnect  {nnn.) 

NSP  has  broken  the  logical  link  betore  the  transfer  has  been  completed. 
HLD  —  Network  open  failure  {-nnn.) 

HLD  could  not  successfully  issue  the  OFNS  macro.  Check  to  see  if  the 
local  node's  state  is  ON. 

HLD  —  node/tajk  —  Network  read  failure  {-nnn.) 

A  communication  error  has  occurred  at  the  remote  SLD.  The  logical  link 
is  broken. 

HLD  —  Network  SPA  failure  {-nnn.) 

HLD  could  not  successfully  issue  the  SPA-S  macro. 

HLD  —  node/task  —  Network  write  failure  {-nnn.) 

A  communication  error  has  occurred  at  the  remote  .SLD.  The  lofiical  link 
is  broken. 

HLD  —  ncdeltask  —  No  entry  in  node/task  tables 

Your  mapping  tables  do  not  contain  an  HTASKS  macro  that  corresponds 
to  the  task  name  from  the  error  message. 

HLD  —  NS:  Work  LUN  assignment  failure  {-nnn.) 

HLD  could  not  successfully  assign  one  of  its  nonmailbox  Ll'Ns  to  the  NS: 
device. 
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HLD  —  node/task  -—  Open  failure  {-nnn.) 
HLD  —  Wespec 

The  file  named  by  the  HTASKS  macro  could  not  be  opened  successtully. 
If  there  is  an  F("S  problem,  you  must  rebuild  the  file.  If  not.  change  either 
the  file  or  the  mapping  table.  If  you  change  the  file  name,  make  it  match 
the  mapping  table.  If  you  change  the  mapping  table,  make  it  match  the 
file  name. 

HLD  —  node/task  —  Partition  Is  larger  than  CHKPT  space 
HLD  —  Wespec 

The  partition  size  in  the  KSX-llS  system  is  larger  than  the  checkpoint 
space  inside  the  tile.  Typically,  this  indicates  that  the  partition  size  in 
your  PAR  statement  is  smaller  than  the  partition's  real  size  in  the 
RSX-llS  system.  Although  the  load  size  of  a  task  can  be  much  smaller 
than  its  partition,  the  entire  partition  is  transferred  during  checkpoint 
operations.  Rebuild  the  file  with  the  same  partition  size  as  the  RSX  IKS 
.system. 

HLD  ~  node/task  —  SLD  abort/disconnect 

This  error  message  indicates  that  SLI)  detected  a  file  error  during  an 
initial  load  or  checkpoint  read.  Reinstall  the  task  into  the  RSX  IIS  sys- 
tem. 

HLD  —  nodeltask  —  SLD  premature  disconnect 

SLD  has  disconnected  during  a  checkpoint  write  before  the  transfer  is 
complete. 
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14.4    NCP  Error  Messages 


There  are  two  sets  ot  error  messages  lor  NCI':  a  lull  set  tor  KS\  llM  and 
HSX  llM  PLl'S  systems  and  a  subset  for  HSX  1  IS  s\ stems.  There  are  two 
groups  ot  messages  within  the  full  set;  one  group  is  HSX  system-specitic.  and 
the  other  is  standard  lor  all  DKCnet  systems,  '{"he  error  message  (le>(ription> 
below  identify  each  message  as  being  HSX-specific.  HSX  1)S.  or  >tandard 
DKCnet. 

14.4.1    RSX-11M/M-PLUS  Error  Message  Format 

The  general  tormat  lor  an  HSX    11  M  M    IM^CS  NCI'  ermr  nu"-^age  i>: 

NCP         ■  ciimpii'-'c  it>,]<vtimmand        (ii(i,L:n(i>>ttc    .     rrmr  n],ss(iiir 
[.<crn)r  detail'^]  >  rxtra  trxt  ^] 


where 

v'lnipnfU'rU 

('(^mmand 
diai-nastiv 


is  the  alleeted  ci»mponent  dor  exam|)le.  LINK  hnr-idK  Ap- 
pears only  in  a  command  altecting  multi|;le  i<»mponent>. 

is  the  fommand  that  caused  the  error. 

is  (!ne  ol  the  following  values: 

KAILKI) 

The  fommand  was  accepted  by  NCP.  but  execution  failed. 

NOT  ACCKPTKI) 

NCP  would  not  accept  the  command,  and  execution  was  not 
attempted.  When  NCi*  rejivt.-  a  command,  it  displays  the 
command  line  with  two  right  angle  bracket .^  at  the  point 
where  NCP  stopped  parsing,  if  NCP  was  parsing  a  pair  of 
words,  it  points  to  the  first  word  of  the  j)air  even  it  the  second 
word  was  incorret  for  example. 


SET    E    ECUTOry 


rvOIJTING    RIMEP 


NCP  does  not  recognize  HOCTINCi  RIMKH.  Since  both 
words  make  up  one  parameter,  NCl^  reiect>  the  parameter 
and  places  brackets  in  front  of  it. 
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error  message 


error  detail 


is  the  major  reason  for  the  failure.  In  most  cases,  these  rea- 
sons are  identical  for  all  DECnet  implementations  (see  the 
DNA  Network  Management  Functional  Specification). 

If  NCP  cannot  interpret  an  internal  error  code,  the  error 
message  field  contains  one  of  the  following: 

Management  return  Un 

An  error  code  of  n  (decimal)  was  returned  by  network  man- 
agement software. 

System  return  «n 

An  error  code  of  n  (decimal)  was  returned  by  the  RSX  opera- 
ting system  software. 

is  a  detailed  explanation  of  the  failure  (for  certain  error  mes- 
sages). All  DECnet  implementations  have  the  same  defini- 
tions for  these  messages.  See  the  DNA  Network  Management 
Functional  Specificati  n  for  details. 

If  NCP  cannot  interpret  an  error  detail  code,  the  error  detail 
field  contains  detail  ttn,  meaning  that  an  error  detail  of  n 
(decimal)  was  returned  by  network  management  software. 

is  an  additional  system-specific  explanation  of  the  error  con- 
dition. For  a  description  of  the  contents  of  this  field  in  an 
error  from  a  non-DECnet-RSX  implementation,  consult  the 
documentation  for  that  system. 


14.4.2    RSX-11S  Error  Message  Format 

The  general  format  for  an  RSX- US  NCP  error  message  is: 

NCP  —  < error  message> 

where 

error  message      See  description  given  above  for  RSX- 11 M/M- PLUS 


extra  text 
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14.4.3    NCP  Error  Messages 

NCP  —  Bad  loopback  response 

(Standard  DECnet)  The  message  that  was  returned  in  a  loopback  test  did 
not  match  the  message  that  was  sent.  This  can  be  due  to  a  loopback 
protocol  violation,  bad  data  returned,  or  bad  message  length  returned. 

NCP  —  Bad  management  response 

(Standard  DECnet)  The  information  returned  to  NCF  either  from  its 
internal  network  management  functions  or  from  the  network  management 
listener  was  improperly  formatted  or  contained  an  invalid  value.  This 
error  condition  implies  a  programm.ing  error  in  the  module  that  resp.  ided 
to  NCP. 

NCP  —  Circuit  in  wrong  state 

(RSX-US)  The  current  operational  state  of  the  circuit  precludes  the  re- 
quested operation. 

NCP  —  Component  in  wrong  state 

(Standard  DECnet)  The  current  operational  state  of  the  component  pre- 
cludes the  requested  operation  (for  example,  you  cannot  down-line  load  a 
line  that  is  off).  The  error  detail  included  with  this  message  identifies  the 
component  (for  example,  circuit,  line.  node,  and  so  on). 

When  a  LOOP  CIRCl'IT  command  is  given  on  an  RSX  system,  one  of  the 
following  RSX  system-specific  extra  text  messages  may  be  included: 

Circuit  is  loopback  node 

The  circuit  is  currently  associated  with  a  loop  node  name,  and  its  state 
cannot  be  changed  to  do  the  circuit  test. 

Circuit  not  restarted 

An  attempt  was  made  to  return  the  circuit  to  normal  u.se  before  the 
circuit  had  been  restarted. 

Device  off  iine 

The  circuit  is  no  longer  on  the  I/O  bus.  This  message  is  specific  to 
RSX-llM-PLUS. 
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Other  management  circuit  service  active 

The  circuit  is  currently  being  used  to  perform  some  other  network 
management  circuit  service  function,  such  as  an  up-line  dump  or  a 
down-line  load. 

Reassign  circuit  to  former  owner  faiied 

At  the  completion  of  the  test,  the  owner  attempted  to  return  the  cir- 
cuit to  normal  use.  The  attempt  failed  because  the  circuit  could  not  be 
given  back  to  the  owner, 

NCP  —  Error  reading  command 

(RSX-specific)  NCP  could  not  read  a  command  from  either  the  terminal 
or  a  command  tile  because  of  a  hardware  error  or  an  unrecognized  com- 
mand read  error. 

NCP  —  Exceeded  command  file  nesting  depth 

(RSX-specific)  A  command  file  attempted  to  start  another  command  file 
when  there  were  already  six  command  files  nested. 

NCP  —  File  I/O  error 

(Standard  DF^Cnet)  A  hardware  error  was  encountered  while  reading  or 
writing  one  of  the  files  necessary  to  the  requested  operation.  The  error 
detail  included  with  this  message  identifies  the  type  of  file: 


Dump  file 
Load  file 

Permanent  data  base 
Secondary  dumper 

Secondary  loader 

Tertiary  loader 

NCP  —  File  open  error 


Output  file  for  an  up-line  dump 

Input  file  for  a  down-line  load 

File  containing  default  parameters 

Input   file  for  the  secondary  dumper  program 
that  runs  in  the  target  node 

Input  file  for  the  secondary  loader  program  that 
runs  in  the  target  node 

Input  file  for  the  tertiary  loader  program  that 
runs  in  the  target  node 


(Standard  DECnet)  One  of  the  files  necessary  for  the  requested  operation 
could  not  be  reserved  for  use.  The  error  detail  is  the  same  as  that  de- 
scribed above  for  the  File  I/O  error  message. 
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NCP  —  File  privilege  violation 

(RSX-specific)  The  file  specified  with  the  TO  option  in  a  SHOW  com- 
mand is  not  available  to  the  user  of  NCP. 

NCP  —  Hardware  failure 

(Standard  DECnet)  The  requested  operation  could  not  be  performed  be- 
cause a  related  hardware  component  failed  to  function  as  needed. 

NCP  —  Incompatible  management  version 

(Standard  DECnet)  The  network  management  listener  version  is  incom- 
patible with  NCP. 

NCP  —  Invalid  device  name  syntax 

(RSX-specific)  The  device  name  in  a  command  file  or  TO  specification 
did  not  have  legal  syntax. 

NCP  —  Invalid  directory  syntax 

(RSX-specific)  The  directory  identification  (I'lC)  in  a  cr)mmand  file  or  a 
TO  specification  did  not  have  legal  syntax. 

NCP  —  Invalid  file  contents 

(Standard  DECnet)  The  requested  operation  could  not  be  performed  be- 
cause the  files  contained  data  of  an  invalid  form  or  value.  The  error  detail 
is  the  same  as  that  described  previously  for  the  File  I/O  error  message. 

NCP  —  Invalid  file  name  syntax 

(RSX-specific)  The  file  name  in  a  command  file  or  a  TO  file  specification 
did  not  have  legal  syntax. 

NCP  —  Invalid  identification  format 

(Standard  DECnet)  The  identification  of  the  component  involved  in  the 
requested  operation  did  not  have  proper  syntax  (for  example,  a  numeric 
character  in  a  node  name).  The  error  detail  included  with  this  message 
identifies  the  type  of  component  (for  example,  line,  node,  circuit,  and  so 
on). 

NCP  —  Invalid  length  value,  maximum  loop  length     128 

(RSX-llS)  The  value  of  the  length  parameter  in  a  LOOP  NODE  com- 
mand exceeds  the  buffering  capability  of  subset  XPT.  I'se  a  smaller  value 
for  the  length  parameter. 
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NCP  —  Invalid  message  format 


(Standard  DKCnet)  The  information  sent  by  NCP  either  to  its  internal 
network  management  timet  ions  or  to  a  network  management  listener  was 
improperly  formatted  or  contained  an  invalid  value.  This  error  condition 
implies  a  programming  eirof  in  \CV. 

NCP  —  Invalid  parameter  grouping 

(Standard  DF.Cnet)  The  parameters  furnished  by  the  user  for  the  re- 
quested operation  cannot  be  included  in  a  single  command. 

NCP  —  Invalid  parameter  value 

(Standard  DECnet)  The  value  of  a  parameter  furnished  by  the  user  for  the 
requested  operation  was  not  acceptal)le  (for  example,  a  numeric  parame- 
ter out  of  range).  The  error  detail  included  with  this  message  identifies  the 
type  of  parameter. 

In  the  case  of  the  events  parameter  for  the  LOCiCiINd  command,  the 
following  RSX  system  specific  extra  text  message  may  be  provided: 

Event  cannot  be  filtered 

The  ability  to  enable  or  disable  one  of  the  specified  events  is  not 
implemented. 

In  the  case  of  the  length  parameter  for  a  LOOP  command,  one  of  the 
following  RSX  system-specific  extra  text  messages  may  be  included. 
In  each  of  these  cases,  the  length  was  more  than  could  be  handled,  and 
the  maximum  length  will  be  included  with  the  error  message. 

Active  looper  size  exceeded 

The  requested  length  exceeds  the  buffering  capability  of  the  active 
looper  task.  Reduce  the  looper's  size  or  reinstall  the  looper  with  a 
memory  increment. 

Mirror  size  exceeded 

The  requested  length  exceeds  the  buffering  capability  of  the  network 
management  loopback  mirror.  Either  use  a  smaller  length  or  (on  an 
RSX  svstem)  reinstall  the  mirror  with  a  memorv  increment. 


• 
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NCP  —  Line  communication  error 

(Standar(i  DKCnt'ti  The  rtHjuestt'd  operalion  tailed  heiaust' of  coriinHini- 
cation  errors  itn  the  involved  line.  This  error  ioiiditi')n  applies  onK  to 
tunclions  thai  involve  direct  use  ot  a  line,  siuh  as  down-line  load  and  line 
loop  tests. 

In  the  case  of  a  LOOP  LINK  eonimand.  one  of  the  following'  HSX  -v^tem- 
speiitic  extra  text  inessa^'es  may  be  included; 

Receiver 

The  ioc.per  (ailed  to  receive  a  message  that  should  have  been  looped 
hack  on  the  line. 

Transmitter 

The  looper  tailed  to  transmit  a  mes.sjge  on  the  line.  Thi>  i>  >pe(  iiically 
a  failure  of  the  transmit  function. 

NCP  —  Line  protocol  error 

(Standard  DKCnetl  The  requested  operation  failed  because  of  protocol 
errors  on  the  involved  line.  This  usually  implies  either  incompatible  line 
proto(.(.!-s  (»r  protocol-proKrammintr  errors.  There  i>  a  po>sil)ility  that  the 
condition  is  cau.sed  by  a  line  hardware  error  that  was  not  detected  by  the 
line  {)rotocol. 

Line  prf)tocol  can  mean  either  the  Data  Link  fVotocol  or  the  service  opera- 
tion protocol. 

This  error  condition  applies  only  to  functions  invoking  direct  use  of  a  line, 
such  as  down-line  load  and  line  loop  tests. 

NCP  —  Listener  connect  failed 

•  Standard  DKOnet)  The  lojjical  link  from  NCP  to  the  network  manage- 
ment listener  could  not  be  connected.  This  error  message  ^enerallv  ha>  one 
<»f  the  following  error  details: 

Access  control  rejected 

The  remote  node  or  the  network  management  listener  could  n(tt  under- 
stand or  would  not  accept  the  access  control  information. 

Invalid  node  name  format 

The  executor  rejected  the  format  of  the  remote  node  name  (for  exam- 
ple, the  name  contained  illegal  characters  or  was  too  long). 
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invalid  object  name  format 

The  remote  node  did  not  understand  the  object  name  format  used  by 
NCP  to  identify  the  network  management  listener. 

Locai  node  shut  down 

The  executor  node  is  in  the  process  of  shutting  down  and  will  not 
accept  logical  link  connections. 

Network  resources 

F^ither  the  local  cr  the  remote  node  had  insufficient  network  resources 
to  connect  the  logical  link. 

No  response  from  object 

The  network  management  listener  did  not  respond.  This  could  be.  for 
example,  due  to  its  responding  too  slowly  or  terminating  abnormally. 

Node  unreachabie 

No  path  exists  to  the  remote  node. 

Object  too  busy 

The  remote  node  had  insufficient  resources  available  to  forward  the 
connect  request  to  the  network  management  listener. 

Remote  node  shut  down 

The  remote  node  is  in  the  process  of  shutting  down  and  will  not  accept 
logical  link  connections. 

Unrecognized  node  name 

The  destination  node  name  does  not  correspond  to  any  known  node 
address. 

Unrecognized  object 

The  remote  node  does  not  have  a  network  management  listener. 

NCP  —  Listener  link  disconnected 

(Standard  DECnet)  The  logical  link  from  NCP  to  the  network  manage- 
ment listener  was  unexpectedly  disconnected.  This  error  message  will 
have  one  of  the  following  errf)r  details: 

Abort  by  management 

An  operator  or  program  used  network  management  to  abort  the  logical 
link.  NCP  recognizes  this  condition,  although  i)KCnet  HSX  does  not 
support  the  ability  to  cause  it. 
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Abort  by  object 

The  network  management  listener  aborted  the  logical  link.  This  indi- 
cates a  programming  error  in  the  network  management  listener. 

Disconnect  by  object 

The  network  management  listener  disconnected  the  logical  link.  This 
indicates  a  programming  error  in  the  network  management  listener. 

Node  or  object  failed 

The  network  aborted  the  logical  link  for  one  of  the  following  reasons: 
The  remote  node  terminated  abnormally,  or  the  network  management 
listener  terminated  abnormally. 

Node  unreachable 

The  network  aborted  the  logical  link  because  it  could  no  longer  find  a 
path  to  the  remote  node. 

NCP  —  Management  program  error 

(Standard  DECnet)  The  network  management  software  has  detected  an 
internal  programming  error. 

NCP  —  Mirror  connect  failed 

(Standard  DECnet)  The  logical  link  to  the  network  management  loopback 
mirror  could  not  be  connected.  This  error  message  generally  has  one  of  the 
following  error  details: 

Access  control  rejected 

The  remote  node  or  the  network  management  loopback  mirror  either 
could  not  understand  or  would  not  accept  the  access  control  informa- 
tion. 

Invalid  node  name  format 

The  executor  rejected  the  format  of  the  remote  node  name  (for  exam- 
ple, the  name  contained  illegal  characters  or  was  too  long). 

invalid  object  name  format 

The  remote  node  did  not  understand  the  object  name  format  used  to 
identify  the  network  management  loopback  mirror. 

Local  node  shut  down 

The  executor  node  is  in  the  process  of  shutting  down  and  is  accepting 
no  more  logical  link  connections. 
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Network  resources 

Either  the  local  or  the  remote  node  had  insufficient  network  resources 
to  connect  the  logical  link. 

No  response  from  object 

The  network  management  loopback  mirror  did  not  respond.  This  could 
be,  for  example,  due  to  its  responding  too  slowly  or  terminating  abnor- 
mally. 

Node  unreachable 

No  path  exists  to  the  remote  node. 
Object  too  busy 

The  remote  node  had  insufficient  resources  available  to  forward  the 
connect  request  to  the  network  management  loopback  mirror. 

Rejected  by  object 

The  logical  link  could  not  be  connected  because  the  network  manage- 
ment loopback  mirror  rejected  the  connecticm.  This  most  likely  implies 
that  the  loopback  mirror  is  too  busy  to  £  jcept  another  logical  link. 

Remote  node  shut  down 

The  remote  node  is  in  the  process  of  shutting  down  and  will  accept  no 
more  logical  link  connections. 

Unrecognized  node  name 

The  destination  node  name  does  not  correspond  to  any  known  node 
address. 

Unrecognized  object 

The  remote  node  does  not  have  a  network  management  loopback  mir- 
ror. 


• 
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NCP  —  Mirror  link  disconnected 

(Standard  DECnet)  The  logical  link  from  NCP  to  the  network  manage- 
ment listener  was  unexpectedly  disconnected.  This  error  message  gener- 
ally has  one  of  the  following  error  details: 

Abort  by  management 

An  operator  or  program  used  network  management  to  abort  the  logical 
link.  NCP  recognizes  this  condition,  although  DECnet-RSX  does  not 
support  the  ability  to  cause  it. 

Abort  by  object 

The  network  management  loopback  mirror  aborted  the  logical  link. 
This  indicates  a  programming  error  in  the  network  management  loop- 
back  mirror. 

Disconnect  by  object 

The  network  management  loopback  mirror  disconnected  the  logical 
link.  This  indicates  a  programming  error  in  the  network  management 
loopback  mirror. 

Node  or  object  failed 

The  network  aborted  the  logical  link  because  either  the  remote  node  or 
the  network  management  loopback  mirror  terminated  abnormally. 

Node  unreachable 

The  network  aborted  the  logical  link  because  it  could  no  longer  find  a 
path  to  the  remote  node. 

NCP  —  NCP  program  error 

(RSX-specific)  NCP  detected  an  internal  programming  error. 
NCP  —  No  room  for  new  entry 

(Standard  DECnet)  The  requested  operation  could  not  be  performed  be- 
cause it  required  the  addition  of  a  new  entry  in  some  data  base  and  that 
data  base  was  full. 


Utility  Error  Messages       14-33 


NCP 


Error  Messages 


NCP  —  Not  remotely  executable 

(Standard  DECnet)  The  requested  operation  cannot  be  sent  to  a  remote 
node. 

NCP  —  Operation  failure 

(RSX-llS)  The  requested  operation  failed  for  one  of  the  following  reasons: 
a  circuit  was  not  owned  by  XPT  or  could  not  be  turned  off,  a  node  was  not 
in  the  XPT  data  base,  or  XPT  was  not  loaded. 

NCP  —  Operation  failure 

(l^iandard  DECnet)  The  requested  operation  failed.  For  some  RSX  sys- 
tem-specific failures,  one  of  the  following  extra  text  messages  may  be 
included: 

DLX  error  #n 

A  direct  line  control  (DLX)  function  failed  with  decimal  error  code  n. 
Consult  DLX  documentation  for  an  explanation  of  the  error  code. 

Insufficient  buffer  space  for  additional  aliases 

The  network  management  software  could  not  internally  buffer  all  the 
aliases  that  could  have  been  displayed. 

insufficient  buffer  space  for  additional  nodes 

The  network  management  software  could  not  internally  buffer  all  the 
nodes  that  could  have  been  displayed. 

Insufficient  buffer  space  for  additional  objects 

The  network  management  software  could  not  internally  buffer  all  the 
objects  that  could  have  been  displayed. 

Network  initializer  function  failed 

The  network  initializer  (NTINTT)  failed  to  perform  its  part  of  the 
requested  operation.  The  network  initializer  will  write  an  error  mes- 
sage to  the  requesting  terminal  or.  in  the  case  of  a  remotely  executed 
command,  to  the  system  console. 

Network  initializer  not  installed 

The  network  initializer  could  not  run  because  it  is  not  properly  in- 
stalled. 
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Network  loader  function  failed 

The  network  loader  (NTL)  failed  to  perform  its  part  of  the  requested 
operation.  The  network  loader  will  write  an  error  message  to  the  re- 
questing terminal  or,  in  the  case  of  a  remotely  executed  command,  to 
the  system  console. 

Network  loader  not  installed 

The  network  loader  could  not  run  because  it  is  not  properly  installed. 
Node  in  wrong  state 

The  requesting  operation  could  not  be  performed  because  the  executor 
node  is  in  the  wrong  state. 

PSI  not  generated 

An  attempt  was  made  to  perform  a  PSI  operation  on  a  system  that 
does  not  support  PSI. 

Server  task  not  installed 

The  separate  task  needed  to  perform  the  requested  operation  is  not 
properly  installed.  This  could  be  the  active  looper  for  a  loop  test,  the 
down-line  loader  for  a  down-line  load  or  trigger,  or  the  up-line  dumper 
for  an  up-line  dump. 

NCP  —  Oversized  management  command  response 

(Standard  DECnet)  The  command  message  sent  by  NCP  was  too  big  for 
the  network  management  listener. 

NCP  —  Oversized  management  response 

(Standard  DECnet)  The  response  message  returned  by  the  network  man- 
agement listener  was  too  big  for  NCP. 

NCP  —  Parameter  missing 

(Standard  DECnet)  The  user  did  not  supply  a  parameter  that  is  necessary 
for  the  requested  operation.  The  error  detail  included  with  this  message 
identifies  the  type  of  the  parameter. 

NCP  —  Parameter  not  applicable 

(Standard  DECnet)  The  user  supplied  a  parameter  that  is  not  applicable 
to  the  requested  operation  on  the  specified  component.  The  error  detail 
included  with  this  message  identifies  the  type  of  parameter. 


Utility  Error  Messages       14-35 


NCP 


Error  Messages 


NCP  —  Parameter  value  too  long 

(Standard  DECnet)  The  user  supplied  a  parameter  value  that  was  too 
long  to  be  accepted  by  the  network  management  listener.  The  error  detail 
included  with  this  message  identifies  the  type  of  the  parameter. 

NCP  —  Privilege  violation 

(Standard  DECnet)  The  user  does  not  have  sufficient  privilege  to  perform 
the  requested  operation. 

In  the  case  of  a  LOOP  LINE  or  LOOP  CIRCriT  command,  the  following 
RSX  system-specific  extra  text  message  may  print  out: 

Service  access  denied 

The  line  or  circuit  is  not  in  vSERVICF]  state  and  the  nonprivileged  user 
cannot  perform  a  line  or  circuit  test. 

NCP  —  Resource  error 

(Standard  DECnet)  Network  management  had  insufficient  internal  re- 
sources to  perform  the  requested  operation. 

NCP  —  System  in  wrong  state 

(RSX-specific)  NCP  cannot  perform  the  requested  function  because  the 
DECnet  system  (the  Communications  Flxecutive)  has  not  been  properly 
initialized. 

NCP  —  System-specific  management  function  not  supported 

(Standard  DECnet)  The  requested  operation  is  RSX  system  specific  and 
is  not  supported  by  the  network  management  listener. 

NCP  —  Unrecognized  circuit  identification 

(RSX  US)  The  circuit  specified  by  the  u.ser  does  not  exist  or  did  not 
contain  necessary-  information  (such  as  a  tributary'  number). 

NCP  —  Unrecognized  command 

(Standard  DPXnet)  NCP  does  not  have  the  command  the  user  entered. 

NCP  —  Unrecognized  command 

(RSX  US)  NCP  does  not  have  the  command  that  the  user  entered,  or  the 
command  contained  an  unrecognized  keyword  or  an  invalid  parameter 
value  (for  example,  a  node  name  contained  7  characters  instead  of  the 
allowed  6-character  name). 
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NCP  —  Unrecognized  component 

(Standard  DKCneli  The  component  specilied  by  the  user  docs  not  exist. 
The  error  detail  included  with  this  message  icientilies  the  type  ot  compo- 
nent (lor  example,  line.  node,  circuit,  and  so  torthi. 

In  the  case  ot  the  LOOP  LINK  command,  the  lollowing  KSX  system- 
s|)eciric  extra  text  messagt'  may  he  displayed; 

Or  line  cleared 

The  line  mav  be  defined  in  the  svstem  configuration,  but  it  is  in  the 
("LKAHKD  state. 

NCP  —  Unrecognized  device  or  unit 

(RSX-spe'.'it'ici  The  device  name  or  unit  number  in  a  command  tile  or  a 
TO  file  specification  could  not  be  found  by  the  RSX  operating  system. 

NCP  —  Unrecognized  file,  device,  or  directory 

(HSX-specific)  The  file  name,  device  name,  or  director\'  (I'lC)  in  a  com- 
mand file  or  a  TO  file  specitication  could  not  be  found  by  the  RSX  opera- 
ting system. 

NCP  —  Unrecognized  function  or  option 

(Standard  DECrM  The  requested  operation  is  not  implemented  by  the 
executor. 

NCP  —  Unrecognized  keyword 

(Standard  DECnet)  One  of  the  kevwords  in  a  command  is  unknown  to 
NCF. 

NCP  —  Unrecognized  line  identification 

(RSX-llS)  The  line  specified  by  the  user  does  not  exist  or  did  not  contain 
necessary  information  (such  as  a  tributary-  number). 

NCP  —  Unrecognized  node  identification 

(RSX- US)  The  node  specified  by  the  user  does  not  exist. 

NCP  —  Unrecognized  parameter  type 

(Standard  DECnet)  One  of  the  parameters  given  by  the  user  is  not  imple- 
mented by  the  executor.  The  error  detail  included  with  this  message  iden- 
tifies the  type  of  parameter. 
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NCP  —  Unrecognized  value 

(Standard  DECnet)  A  parameter  value  given  bv  the  user  was  unknown  to 
NCP. 

NCP  —  Value  out  of  range 

(Standard  DECnet)  A  parameter  value  given  by  the  user  is  out  of  the 
range  implemented  in  NCP. 
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NDA  prints  an  error  message  on  your  terminal  when  it  detects  one  of  the  error 
conditions  described  below.  These  error  messages  reflect  operational  condi- 
tions and  must  not  be  confused  with  the  diagnostic  analysis  messages  that 
NDA  generates  during  the  analysis  and  prints  in  the  analysis  listing. 

Note  that  a  few  of  the  messages  listed  below  are  informational  in  nature,  while 
most  are  fatal  errors  resulting  in  termination  of  the  analysis. 

NDA  —  Analysis  output  must  be  directed  to  an  explicit  device  or  file 

(Fatal)  NDA  requires  an  explicit  output  file  specification.  There  are  no 
default  output  file  names. 

NDA  ~  Analysis  terminated  after  n  pages 

(Informational)  NDA  terminated  the  analysis  after  generating  n  pages  of 
analysis  output. 

NDA  —  Command  I/O  error 

(Fatal)  The  system  returned  an  error  when  NDA  attempted  to  read  a 
command  line. 

NDA  —  Command  line  syntax  error 

(Fatal)  NDA  detected  an  error  in  the  syntax  of  an  NDA  command  line. 
NDA  points  to  the  error  within  the  command  line. 

NDA  — -  Crash  dump  must  be  input  from  an  explicit  device  or  file 

(Fatal)  The  crash  dump  input  file  specification  must  be  explicit.  There  is 
no  default  file  specification  for  the  crash  dump  input. 

NDA  ~  Device  driver  missing 

(Fatal)  You  have  not  loaded  the  driver  for  the  crash  dump  input  device. 
NDA  —  Error  reading  crash  dump 

(Fatal)  NDA  either  could  not  read  or  could  not  access  the  crash  dump 
input  device.  The  device  may  not  be  properly  allocated  or  may  contain 
bad  blocks. 

NDA  —  Error  reading  file  filename 

(Fatal)  The  system  returned  an  error  when  NDA  attempted  to  read  the 
crash  dump  file.  This  could  be  caused  by  a  device  error  or  a  bad  block  on 
the  volume. 
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NDA  —  Error  reading  symbol  file  filename 

(Fatal)  The  system  returned  an  error  when  XDA  attempted  to  read  the 
symbol  table  definition  file. 

NDA  —  Error  writing  analysis  file 

(Fatal)  The  system  returned  an  error  when  NDA  attempted  to  write  a  line 
into  the  analysis  listing  file.  This  could  be  caused  by  a  problem  with  the 
device,  a  full  volume,  or  a  bad  block  on  the  volume. 

NDA  —  Error  writing  dump  file  filename  Error=n  DSW=n 

(Fatal)  The  system  returned  an  error  when  NDA  attempted  to  write  into 
the  binary  output  file.  This  condition  could  be  caused  by  a  problem  with 
the  device,  a  full  volume,  or  a  bad  block  on  the  volume. 

NDA  ~  Errors  detected:  n 

(Informational)  NDA  detected  n  analysis  errors  during  the  run. 

NDA  —  Failed  to  assign  LUN  to  input  device  ddu 

(Fatal)  A  directive  to  assign  a  LUN  failed  when  NDA  attempted  to  use  it 
to  attach  the  specified  input  device  before  reading  the  crash  dump  from 
the  device.  The  directive  to  assign  a  LUN  fails  if  the  device  name  in  the 
NDA  command  line  is  invalid. 

NDA  —  Failed  to  extend  page  buffer  —  n  pages  available 

(Informational)  A  directive  to  extend  the  task  failed  when  NDA  at- 
tempted to  use  it  to  expand  the  page  buffer.  This  problem  causes  the 
analysis  to  take  longer,  but  the  analysis  continues  with  a  buffer  of  n  pages, 
each  266  words  long. 

NDA  —  Failed  to  open  input  file  filename 

(Fatal)  One  of  the  following  conditions  exists: 

•  The  specified  device  does  not  exist. 

•  The  volume  is  not  mounted. 

•  A  problem  exists  with  the  device. 

•  The  specified  UFD  does  not  exist. 

•  The  specified  file  does  not  exist. 

•  You  do  not  have  read  access  privileges. 


€ 


14-40       DECnet-RSX  System  Manager's  Guide 


NDA 

Error  Messages 


NDA  —  Failed  to  open  output  file  filename 

(Fatal)  One  of  the  following  conditions  exists: 

•  The  specified  device  does  not  exist. 

•  The  volume  is  not  mounted. 

•  A  problem  exists  with  the  device. 

•  The  specified  UFD  does  not  exist. 

•  The  volume  is  full  or  the  device  is  write  protected. 

•  You  do  not  have  write  access  privileges  to  UFD. 

NDA  —  Illegal  switch 

(Fatal)  You  have  specified  an  unknown  switch  or  have  used  a  valid  switch 
after  the  wrong  file  specification. 

NDA  —  Illegal  trap  —  snapshot  dump  being  attempted 

(Fatal)  NDA  has  aborted  after  detecting  an  odd  address  or  some  other 
type  of  fault.  This  is  an  indication  of  a  software  problem. 

NDA  —  Indirect  command  syntax  error 

(Fatal)  The  name  of  the  indirect  command  file  {{fi  filename)  is  syntacti- 
cally incorrect. 

NDA  —  Indirect  file  open  failure 

(Fatal)  NDA  could  not  open  an  indirect  command  file  specified  as 
i^i  filename  in  the  NDA  command  line. 

NDA  —  Maximum  indirect  file  depth  exceeded 

(Fatal)  You  have  exceeded  the  maximum  allowable  number  of  nested 
indirect  command  files  (only  one  level  of  indirection  is  permitted  in 
NDA).  The  rest  of  the  top  level  command  file  is  executed. 

NDA  ~  No  input  file  specified 

(Fatal)  You  did  not  supply  an  input  file  specification  for  the  crash  dump. 
NDA  —  No  output  file  specified 

(Fatal)  You  have  not  specified  an  output  file. 
NDA  —  Output  dump  file  name  must  be  explicit 

(Fatal)  You  have  not  specified  an  output  dump  file. 
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NDA  —  Premature  end  of  dump  input  —  filename  being  zero  filled 

(Informational)  NDA  reached  the  end  of  the  medium  (or  end-of-file  mark, 
if  a  magnetic  tape)  before  the  crash  dump  output  file  had  been  completely 
filled.  If  you  expected  the  file  to  be  completely  filled  by  the  dump,  this 
condition  could  indicate  a  problem. 

NDA  —  Symbol  file  filename  has  illegal  format 

(Fatal)  The  specified  executive  symbol  table  file  has  an  improper  format, 
probably  caused  by  entry  of  the  wrong  file  name.  However,  this  message 
could  also  indicate  a  problem  with  the  device  or  medium  on  which  the  file 
is  located. 

NDA  —  Symbol  symbol-name  not  defined  in  symbol  file 

(Fatal)  NDA  did  not  find  a  symbol  it  required  for  the  analysis  in  the 
specified  executive  symbol  table  file.  The  analysis  may  be  restarted  speci- 
fying the  SYM  switch,  forcing  NDA  to  continue  with  the  analysis,  using  a 
zero  value  for  all  undefined  symbols. 

NDA  —  Transfer  complete  —  ddu  may  be  unloaded 

(Informational)  The  transfer  of  the  crash  dump  to  the  output  file  is  fin- 
ished: you  may  unload  the  crash  dump  device.  This  message  occurs  only 
when  you  have  specified  a  binary  save  file  in  the  command  string  to  NDA. 

NDA  —  Unknown  get  command  line  error 

(Fatal)  L'nrecognized  error  has  occurred  when  NDA  attempted  to  read  a 
command  line. 

NDA  --  Warning  kernel  PARs  do  not  contain  proper  values 

(Informational)  This  message  indicates  that  the  values  contained  in  the 
page  address  registers  are  invalid.  NDA  attempts  to  finish  the  analysis 
using  the  indicated  values.  When  restarting  the  analysis,  you  must  specify 
the  /KMR  switch  (Section  10.7.2).  This  switch  forces  NDA  to  use  standard 
mapping  values  when  converting  kernel  virtual  addresses  to  physical 
memorv  addresses. 
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NTDKMO  prints  an  error  message  on  your  terminal  it  it  detects  one  of  the 
conditions  described  below  when  you  invoke  the  NTD  utility. 

NTDEMO  —  Network  not  loaded 

The  network  at  the  node  is  not  loaded  (that  is,  no  network  software  is 
running  at  the  local  node). 

NTDEMO  —  Unable  to  connect  to  remote  server 

NTD  is  unable  to  commun  cate  with  NTDKMO  on  the  node  you  re- 
quested (that  is.  the  h(»st  i.ode  it  you  typed  -NTD.  or  the  node  you 
specified  if  you  typed  A'TD  rvxic-id).  This  could  l)e  due  to  any  one  of  the 
following  conditions: 

•  The  node  is  unreachable. 

•  The  node  does  not  support  the  NTDKMO  server.  (This  .software  runs 
only  on  DF^Cnet  HSX/IAS  nodes.) 

•  The  node  does  not  have  NTDP'AIO  installed. 

•  The  maximum  number  of  links  to  NTDFAIO  are  bui^y.  (This  value  is 
defined  during  network  generation.) 

NTDEMO  —  Unable  to  open  network 

The  network  at  the  node  is  loaded,  but  not  currently  available  for  network 
operations. 
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14.7    NTINIT  Error  Messages 


The  network  initializer  iNl'INTri  is  used  with  either  NCPor  VNP  to  initial- 
ize the  netvvork  software.  All  N  riNI'l'  errors  are  tatal.  The  attern|)le(l  opera- 
tion eannot  sueceed  unless  the  problem  identitied  in  the  message  is  corrected. 

When  an  NCP  or  a  VNF^  command  executes  locally,  error  messa^'es  are  dis- 
played at  the  recpiestin^  terminal.  When  the  command  executes  remotely, 
error  messages  are  displayed  on  the  remote  .\vstem  console. 

So!ne  of  the  error  messages  include  words  printed  in  italics.  The  italicized 
wt»rds  are  variables.  NTINIT  replaces  them  with  a  specific  term.  For  exam|)le. 
in  the  message  NTINIT  Failed  to  load  line  Imc-id.  the  initializer  replaces 
lirh'-i(i  with  the  actual  line  identification. 

NTINIT  —  Adjacency  data  base  allocation  failure 

There  is  not  enough  free  space  in  the  network  j)ool  (POOL..  I  to  allocate 
the  adjacency  data  base.  Increase  the  size  of  the  network  pool  byte  area 
with  CFK  and  reload  the  network. 

NTiNIT  —  Clearing  system 

NTINIT  is  removing  the  network  software  from  the  system  because  of  a 
failure  on  the  marked-for-load  scan.  To  recover,  use  CFK  to  correct  the 
condition  that  caused  the  failure.  Then  execute  another  SF/r  SVSTKM 
command  and  try  to  load  again.  If  the  failure  recurs,  shut  down  more  lines 
and  circuits  before  loading  again.  Repeat  this  procedure  until  the  load  is 
successful  or  until  all  lines  and  circuits  are  shut  down. 

If  the  error  continues  after  all  lines  and  circuits  are  shut  down,  one  of  the 
processes  is  at  fault.  Set  one  urocess  to  the  CI.F'.AH  state  and  try  the  SKT 
SYSTF.M  command  again.  Repeat  this  action  using  a  different  process 
until  the  SKT  SYSTFIM  command  is  successful.  The  last  process  to  be 
cleared  is  the  faulty  one.  Then  use  CVK  DF.FINK  commands  to  reload  the 
lines,  circuits,  and  processes  (except  the  erring  one  I. 

NTINIT  —  Comm  Exec  not  loaded 

The  Communications  Kxecutive  is  n''t  loaded  in  main  memory.  Cse  the 
NCP  SKT  S^'.STKM  command  to  load  the  network  software. 
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NTINIT  —  Device  controller-id  offline 

The  CSR  address  tor  the  device  does  not  exist  on  the  bus.  I'se  CVF.  to 
change  the  CSR  value  in  the  configuration  file  or  use  the  CSR  keyword 
when  issuing  the  NCP  SET  LINE  command.  If  the  line  is  set  to  OX 
during  NP'TGEX.  you  must  use  the  following  NCP  commands  to  clear  the 
line  and  reload  it: 

NCP     -LEAR    LINE    Imr-id    ALL 

NCP     5ET    LINE    hnr-id    CSrv    drncr-id    STATE     ON 

NTINIT  —  Failed  to  load  line  line-Id 

A  SET  LINE  request  failed.  You  will  also  receive  an  NTL  error  messsage 
that  gives  a  more  detailed  description  of  the  cause  of  the  error  (for  exam- 
ple. NTL  —  Device  off  line). 

NTINIT  —  Failed  to  load  process  process-id 

A  SET  PROCESS  request  failed.  You  will  also  receive  an  NTL  error 
message  that  gives  a  more  detailed  description  of  the  cause  of  the  error  (for 
example,  NTL  —  Process  not  in  system). 

NTINIT  —  Illegal  function 

An  attempt  to  reprogram  the  network  software  resulted  in  a  programming 
error. 

NTINIT  —  Incompatible  with  RSX-11M  system 

The  initializer  was  built  with  the  wrong  RSXllM.STB  file.  Rebuild  the 
network  software  with  the  correct  RSXllM.STB  file. 

NTINIT  —  Incompatible  with  RSX-11S  system 

The  initializer  was  built  with  the  wrong  RSXllS.STB  file.  Rebuild  the 
network  software  with  the  correct  RSXllS.STB  file. 

NTINIT  —  Network  ACP  (NETACP)  not  installed 

XETACP  must  be  installed  to  perform  the  SET  EXECITOR  STATE  ON 
operation.  To  clear  the  problem,  use  the  MCR  INSTALL  NETCAP  com- 
mand to  install  the  network  ACP. 

NTINIT  —  Network  loader  (NTL...)  not  installed 

NTL  must  be  installed  t(»  perform  the  NCP  SET  SYSTEM  operation.  To 
clear  the  problem,  use  the  MCR  INSTALL  NTL  command  to  install  the 
network  loader. 
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NTINIT  —  NS:  assignment  failure 

The  initializer  could  not  assign  one  of  its  LUNs  to  the  network  device. 
There  is  no  recovery  procedure  from  this  failure. 

NTINIT  —  NW:  assignment  failure 

The  initializer  could  not  assign  one  of  its  Ll'Ns  to  the  PSI  network  device. 
There  is  no  recovery  procedure  from  this  failure. 

NTINIT  —  PLB  allocation  failure 

There  is  not  enough  free  space  in  the  dynamic  storage  region  (DSR)  to 
allocate  the  XPT  physical  link  block  data  b  ise.  You  must  run  a  system 
generation  again,  allocating  enough  free  space  in  the  DSR. 

NTINIT  —  Router  priority  data  base  allocation  failure 

There  is  not  enough  free  space  in  the  dynamic  storage  region  (DSR)  to 
allocate  the  router  priority  data  base. 

NTINIT  —  Routing  control  task  not  installed 

The  routing  control  task  must  be  installed  to  perform  the  SET  EXECU- 
TOR STATE  ON  command.  Use  the  MCR  INSTALL  <nctuic>  RCPl 
command  to  install  the  task. 

NTINIT  —  X25  ACP  (X25ACP)  not  installed 

The  X25ACP  must  be  installed  to  set  module  X25-SEHVER  to  ON.  Use 
the  MCR  INSTALL  X25ACP  command  to  install  the  X25ACP. 
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14.8    NTL  Error  Messages 


The  network  loader  (NTL)  loads  and  unloads  network  software  in  response  to 
NCP  commands.  When  an  NCP  command  executes  locally.  NTL  error  mes- 
saj?es  are  displayed  on  the  requesting  terminal.  When  the  command  executes 
remotely,  NTL  error  messages  are  displayed  on  the  remote  console  terminal. 

There  are  ten  types  of  NTL  error  messages.  The  format  of  each  is  outlined 
below.  The  term  messo^c-tcxt  used  in  these  sample  formats  is  replaced  with 
the  actual  message  in  the  error  message  descriptions  that  follow.  The  itali- 
cized word  L-ar  is  replaced  with  a  run-time  variable  in  the  actual  message. 
Some  of  the  variables  are  network  processes,  device  driver  names,  controller 
names,  line  names,  partition  names,  file  names,  vector  values,  and  RSX  de- 
vice names.  Variable  fields  are  ignored  in  the  alphabetization  of  error  mes- 
sages in  this  chapter. 

NTL  —  message-text 

NTL  —  var  message-text 

NTL  —  Config  File  —  message-text 

NTL  —  van  Device  Tables  —  message-fexf 

NTL  —  var  Image  File  —  message-fexf 

NTL  —  var  Microcode  File  —  message-fexf 

NTL  —  var  Process  File  —  message-fexf 

NTL  —  var  Symbol  Name  —  message-fexf 

NTL  —  var  Template  —  message-fexf 

NTL  —  var  Template  File  —  message-fexf 

NOTE 

Only  recoverable  NTL  errors  are  listed  in  this  guide.  Any  un- 
listed error  message  that  you  receive  reflects  an  unrecoverable 
error.  Call  your  Digital  representative  for  assistance. 

NTL  —  dev-id:  allocation  failure 

There  Is  not  enough  space  to  allocate  the  RSX- 11 M  device  data  structures 
(DCB.  I'CB.  and  SCB)  for  one  of  the  netvvork  "devices."  In  this  case, 
device  does  not  refer  to  hardware.  It  refers  to  a  software  structure  to  which 
the  user  program  assigns  its  LUNs  and  directs  its  QIOs. 
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NTL  — -  CCB  allocation  failure 

There  is  not  enough  space  for  all  the  CCBs.  It  is  not  known  how  many  were 
successfully  allocated. 

NTL  —  CETAB  allocation  failure 

There  is  not  enough  dynamic  memory  to  allocate  the  CETAB  data  base. 

NTL  —  Channel  var  still  active 

An  attempt  was  made  to  issue  a  CLEAR  P^ROCESS  command  for  an  LLC 
before  all  its  lines  were  set  to  OFF.  Set  all  the  lines  to  OFF  and  repeat  the 
command, 

NTL  —  Circuit  not  in  system 

An  attempt  was  made  to  load  a  circuit  that  is  not  in  the  system. 
NTL  —  Comm  Exec  has  been  deallocated 

The  space  for  the  Communications  Executive  has  been  deallocated. 

NTL  —  Comm  Exec  incompatible  with  RSX-11M  system 

The  Communications  Elxecutive  was  built  with  the  wrong  RSXllM.STB 
file. 

NTL  —  Comm  Exec  not  loaded 

An  attempt  was  made  to  perform  an  operation  that  requires  the  Commu- 
nications Executive  (CEX)  to  be  loaded  and  it  is  not.  Load  the  CEX  with 
the  NCP  SET  SYSTEM  command. 

NTL  —  Config  File  —  Binary  buffer  overflow 

The  NTL  end-of-task  buffers  are  not  large  enough  to  hold  the  input. 
Install  NTL  with  an  INC  option. 

NTL  —  Config  File  —  Device  var  unibus  run  mask  missing 

The  unibus  run  mask  is  missing  for  the  specified  device. 

NTL  —  Config  File  —  Event  filter  control  block  allocation  failure 

There  is  not  enough  network  pool  and  DSR  to  allocate  an  event  filter 
block. 

NTL  —  Config  File  —  Illegal  CSR  address 

The  specified  CSR  address  is  not  a  legal  value.  Cse  the  correct  CSR 
address. 
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NTL  —  Config  File  —  LLC$DF  process  extension  too  big 

One  system  process  has  an  extension  that  makes  it  larger  than  the  allowed 
4K  maximum. 

NTL  —  Config  File  —  Non-UMR-mapped  area  is  too  large 

The  non-l'MH-mapped  area  specified  in  the  PAR$I)F  macro  is  too  large 
for  the  network  pool  partition. 

NTL  —  Config  File  —  Not  enough  contiguous  UMRs 

Contiguous  I'MRs  are  needed  to  map  the  network  buffer  pool.  Issue  the 
SET  SYSTKM  command  before  you  begin  fragmenting  the  I'MRs  by 
running  othei  jobs.  If  this  fails,  you  can  use  VNP  to  load  the  network 
software  into  the  operating  system  file  instead  of  using  N'CI*  on  the  in-core 
image.  \'NP  is  not  available  on  RSX-llM-FLrS  systems. 

NTL  —  Config  File  —  Object  or  remote  block  allocation  failure 

There  is  not  enough  network  pool  or  DSR  to  allocate  the  object  or  remote 
block.  The  line  from  CETAB  where  the  failure  occurred  is  displayed  so 
that  you  can  determine  which  object  or  remote  block  was  not  allocated. 

NTL  —  Config  File  —  Open  failure  {-error  code.) 

The  system  was  unable  to  open  the  CF^TAB.MAC  file.  See  the  RSX  sys- 
tem documentation  for  the  meaning  of  the  RSX  I/O  error  code. 

NTL  —  Config  File  —  Partition  var  busy 

The  partition  name  specified  for  the  network  pool  is  busy. 

NTL  —  Config  File  —  Partition  var  not  common 

The  partition  specified  for  the  netw-ork  pool  is  not  a  common  partition. 
Remove  that  partition  and  re-create  it  with  the  system-controlled  attrib- 
ute: ^ 

nCR    SET /MA  I  N  =pnrf/ffon-narrir  :  anoa  :  ft/^COM 

NTL  —  Config  File  —  Partition  var  not  In  system 

The  partition  specified  for  the  network  pool  is  not  in  the  system. 

NTL  —  Config  File  —  Partition  var  not  system  controlled 

NTL  requires  the  partition  to  be  system  controlled.  This  error  indicates 
that  the  partition  was  created  as  a  task  or  common  partition.  Remove  that 
partition  and  re-create  it  with  the  .system-controlled  attribute: 

MCrv     SET/NOMA  IN=pf/rf/nV/n-fKj^r!( 

MCR    S£l  /1^(^lN=parnti'm-nrimr'.an(ia'.hhS\'S 
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NTL  —  Config  File  —  Partition  var  too  fragmented 

There  is  not  enough  contiguous  space  in  the  partition  to  load  a  process. 

NTL  —  Config  File  —  Partition  var  too  small  for  RDBs/SDBs 

This  error  pertains  only  to  the  network  hulfer  pool  partition.  The  network 
hutfer  pool  is  not  large  enough  tor  the  large  and  small  data  butlers.  I'se 
(TF]  to  reduce  the  butter  c(Hints  and'or  sizes  or  to  re-create  a  larger  parti- 
tion. 

NTL  —  Config  File  —  Read  failure  (-error  code.) 

The  system  was  unable  to  read  the  CKTAB.MAC  file  See  the  F^SX  sys- 
tem documentation  tor  the  meaning  of  the  HSX  I/O  error  code. 

NTL  —  Config  File  —  Secondary  CSR  off  line 

The  specified  secondary  (\SR  (trom  CK'l'AB.MAO  is  off  line. 

NTL  —  Config  File  —  Sub-PCB  allocation  failure 

There  is  not  enough  space  tor  a  partition  control  block  for  the  network 
buffer  pool. 

NTL  —  Config  File  —  SVC  descriptor  allocation  failure 

There  was  not  enough  DSR  or  network  pool  to  allocate  the  SVC  descriptor. 
NTL  —  Config  File  —  UMR  block  allocation  failure 

There  is  not  enough  space  tor  a  I'MH  assignment  block. 
NTL  —  Config  File  —  Vector  not  In  system 

The  controller's  vector  address  specified  in  the  configuration  Hie  does  not 
exist  in  your  system's  vector  space. 

NTL  —  \far  Device  I/O  error,  CSR     yar,  RAM  address     yar  was  written, 
var  was  read 

An  attempt  to  load  microcode  for  a  KMT  device  failed  due  to  an 
input  output  failure.  One  po.^sible  cause  could  be  a  hardware  failure. 

NTL  ~  Device  off  line 

An  attempt  wa<  made  to  load  a  device  that  is  off  line. 
NTL  —  Device  yar  off  line 

An  attempt  wa>  made  to  load  a  device  that  is  of!  line. 
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NTL  —  Device  dev-id:  still  active 

An  attempt  was  made  to  clear  an  LL('  process  when  the  associated  device 
is  still  active. 

NTL  —  Device  dev-id:  still  mounted 

An  attempt  was  made  to  clear  an  LLC  process  when  the  device  associated 
with  it  is  still  mounted. 

NTL  —  dev-id:  driver  already  resident 

The  executive  data  structure  tor  the  driver  as.sociated  with  the  LLC  pro- 
cess being  loaded  already  exists. 

NTL  —  var  ICB  allocation  failure 

There  is  not  enough  space  in  the  dynamic  storage  region  (l)SHf  to  allocate 
an  interrupt  control  block  (ICB). 

NTL  —  var  image  File  —  Label  block  read  failure  {-error  code.) 

The  system  is  unable  to  read  a  label  block.  See  the  RSX  system  documen- 
tation for  the  meaning  of  the  RSX  I  ()  error  code. 

NTL  —  var  Image  File  —  Open  failure  (-error  code.) 

The  attempt  to  open  the  specified  file  failed.  See  the  RSX  system  docu- 
mentation tor  the  meaning  of  the  RSX  I()  error  code. 

NTL  —  var  Image  File  —  Read  failure  (-error  code.) 

The  attempt  to  read  a  recr)rd  from  a  specified  file  failed.  See  the  RSX 
system  documentation  for  the  meaning  of  the  RSX  LO  error  code. 

NTL  —  Incompatible  with  Comm  Exec 

NTL  has  been  built  with  the  wrong  CKX.STB  file.  Rebuild  NTL  with  the 
correct  (TLX.STB  file. 

NTL  —  Incompatible  with  RSX-11M  system 

NTL  has  been  built  with  the  wrong  RSXl  INLSTB  file.  Rebuild  N'l'L  with 
the  correct  RSXlLNLSTB  file. 

NTL  —  var  KRB  allocation  failure 

There  is  not  enough  space  in  either  the  network   pool  or  the  dsnamic 
storage  region  for  the  controller  request  block  (KRB). 

NTL  —  Line  not  in  system 

An  attem|)t  was  made  to  set  a  line  that  does  not  exist. 
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NTL  —  Line  still  active 

An  attempt  was  made  to  clear  a  line  that  was  still  OX.  Set  the  line  to  OFF 
and  reenter  the  command. 

NTL  —  Line  var  still  ready 

An  attempt  was  made  to  perform  a  CLEAR  PROCESS  on  a  DLC  or  a 
DDM  controller  before  all  of  its  circuits  were  turned  off  and  unloaded.  Set 
the  circuits  to  OFF  and  reenter  the  command. 

NTL  —  var  Line  table  allocation  failure 

There  is  not  enough  space  in  DSR  for  either  a  device  line  table  or  an  LLC 
process  data  base. 

NTL  —  var  Microcode  File  ~  Label  block  read  failure  {error-code.) 

An  attempt  to  read  the  label  block  specified  in  the  command  failed  due  to 
an  input/output  error.  See  the  RSX  system  documentation  for  the  mean- 
ing of  the  RSX  I/O  error  code. 

NTL  —  var  Microcode  File  —  Open  failure  (error-code.) 

An  attempt  to  open  the  file  specified  in  the  command  failed  due  to  an 
input/output  error.  See  the  RSX  system  documentation  for  the  meaning  of 
the  RSX  I/O  error  code. 

NTL  —  var  Microcode  File  —  Read  failure  (error-code.) 

An  attempt  to  read  a  record  from  the  specified  file  failed  due  to  an 
input/output  error.  See  the  RSX  system  documentation  for  the  meaning  of 
the  RSX  I/O  error  code. 

NTL  —  MUX  update  only 

This  is  a  reminder  that  the  vector  and  the  CSR  for  the  device  specified  in 
the  command  line  have  not  been  changed.  All  lines  on  a  multiplexer 
device  are  loaded  when  any  line  on  the  device  is  loaded.  Therefore,  all 
subsequent  loads  for  other  lines  on  this  device  do  not  change  the  vector  or 
the  CSR. 

NTL  —  var  Process  File  —  Incompatible  with  Comm  Exec 

The  process  has  been  built  with  the  wrong  CEX.STB  file. 
NTL  —  var  Process  File  —  Label  block  read  failure  (-error-code.) 


An  attempt  to  read  a  label  block  for  a  process  task  image  file  failed  due  t 
an  input/output  error.  See  the  RSX  system  documentation  for  the  mean 
ing  of  the  RSX  I/O  error  tode. 


o 
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NTL  —  var  Process  File  —  Open  failure  {-error-code.) 

An  attempt  to  open  the  task  ima^e  file  for  the  specified  process  failed  due 
to  an  input/output  error.  See  the  RSX  system  documentation  for  the 
meaning  of  the  RSX  I/O  error  code. 

NTL  —  var  Process  File  —  Partition  var  busy 

The  partition  is  occupied  by  either  another  network  process  or  an 
RSX-UM  resident  library.  The  current  occupant  must  be  unloaded. 

NTL  —  var  Process  File  —  Partition  var  not  common 

NTL  requires  the  partition  to  be  common.  The  partition  has  been  creater 
as  either  task  or  .system  controlled.  Remove  the  partition  and  re-create  i' 
with  the  common  attribute: 

MCR    SET  '  NOMA  lN=p(jrtiti()n-nam> 

^CR-  SET  /  f^ft>lN-part!fi(in-nnrvr  innnn:  hhh-.COf^ 

NTL  —  var  Process  File  —  Partition  var  not  In  Exec  space 

The  Communications  Executive  (CEX)  partition  must  be  contained  com- 
pletely in  the  first  20K  words  of  physical  memory.  This  error  indicates 
that  the  ending  address  of  the  CEX  partition  is  larger  than  this  limit.  The 
CEX  contains  an  end-of-partition  buffer  pcM)l.  If  you  exceed  the  limit  by  a 
small  amount  (100  or  200  octal),  you  can  try  to  reduce  the  CEX's  partition 
size.  Otherwise,  you  should  repeat  the  NETGEN. 

NTL  —  var  Process  File  —  Partition  var  not  In  system 

The  partition  specified  in  your  command  does  not  exist.  Either  create  the 
partition  that  NTL  is  seeking,  or  rebuild  the  component  to  change  the 
partition  assignment. 

NTL  ~  var  Process  File  —  Partition  var  sub-PCB  allocation  failure 

There  is  not  enough  space  for  a  partition  control  block  (PCB)  for  the 
named  process. 

NTL  —  var  Process  File  —  Partition  var  too  fragmented 

This  error  pertains  to  system-controlled  partitions  only.  The  size  of  the 
largest  free  space  in  the  partition  is  smaller  than  the  size  of  the  process 
being  loaded.  The  current  occupants  of  the  partition  must  be  rearranged 
to  make  a  free  space  of  the  size  needed.  NTL  does  not  activate  the 
RSX-llM  shuffler  task.  Manual  recovery  is  necessarv. 
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NTL  —  var  Process  File  —  Partition  var  too  smaii 

This  error  pertains  to  the  common  partition  only.  The  partition  is  smaller 
than  the  size  of  the  process  being  loaded.  The  partition  must  be  created 
with  a  larger  size.  Refer  to  the  TKB  map  for  the  process  to  determine  the 
size  needed. 

NTL  —  var  Process  File  —  Read  failure  (-error-code.) 

An  attempt  to  read  a  record  from  the  process  task  image  file  failed  due  to 
an  input/output  error.  See  the  RSX  system  documentation  for  the  mean- 
ing of  the  RSX  I/O  error  code. 

NTL  —  Process  may  not  be  unloaded 

An  attempt  was  made  to  unload  a  process  that  is  required  for  network 
operation  and  cannot  be  unloaded. 

NTL  —  Process  not  in  system 

An  attempt  was  made  to  set  a  nonexistent  process. 

NTL  —  Reconfiguration  device  not  in  system 

The  reconfiguration  device  for  the  network  devices  is  not  loaded.  Load  the 
device  with  the  DECnet  process  called  DLX. 

NTL  —  var  Symbol  Table  File  —  Open  failure  {-error-code.) 

An  attempt  to  open  the  system  table  file  for  the  specified  process  failed 
due  to  an  input/output  error.  See  the  RSX  system  documentation  for  the 
meaning  of  the  RSX  I/O  error  code. 

NTL  —  var  Symbol  Table  File  —  Read  failure  {-error-code.) 

An  attempt  to  read  a  record  from  the  specified  system  table  file  failed  due 
to  an  input/output  error.  See  the  RSX  system  documentation  for  the 
meaning  of  the  RSX  I/O  error  code. 

NTL  —  System  not  built  with  networl(  support 

This  message  needs  no  explanation. 
NTL  —  var  Template  —  Library  block  allocation  failure 

There  is  no  space  in  the  network  buffer  pool. 

NTL  —  var  Template  —  Resource  allocation  failure 

There  is  not  enough  space  for  the  allocation  size  needed.  (Another  error 
message  follows  that  contains  the  allocation  type  being  attempted.) 
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NTL  —  var  Template  —  Vector  var  not  available 

The  indicated  vector  is  assigned  to  another  user.  The  vector  must  be 
deassigned  from  the  current  user. 

NTL  —  var  Template  —  Vector  i^ar  not  In  system 

The  vector  specified  in  the  command  exceeds  the  maximum  value  as- 
signed at  NETGEN. 

NTL  —  var  Template  File  —  Open  failure  {-error-code.) 

An  attempt  to  open  the  template  file  for  the  specified  process  failed  due  to 
an  input/output  error.  See  the  RSX  .system  dc^cumentation  for  the  mean- 
ing of  the  RSX  I/O  error  code. 

NTL  —  irar  Template  File  —  Read  failure  (-error-code.) 

An  attempt  to  read  a  record  from  the  specified  template  file  failed  due  to 
an  input/output  error.  See  the  RSX  system  documentation  for  the  mean- 
ing of  the  RSX  I/O  error  code. 

NTL  —  Timer  cells  not  found 

NTL  could  not  find  the  process  timer  cells  in  the  Al'X  process. 
NTL  —  Vector  not  in  system 

The  vector  specified  in  the  command  line  does  not  exist  in  your  system's 
vector  space.  The  upper  limit  of  the  vector  space  is  determined  during 
SYSGEX.  Repeat  both  SYSGEN  and  NETGEN. 

NTL  —  var  Vector  set-up  error 

Some  other  user  has  stolen  one  or  more  of  the  interrupt  vectors.  This 
occurred  after  NTL  first  verified  that  the  interrupt  vectors  were  available, 
but  before  NTL  built  the  line  table  and  pointed  the  vector  at  the  table. 
The  vector  must  be  deassigned  from  the  other  user. 

NTL  —  *  WARNING  *  —  Failed  to  reinitialize  HRC 

The  network  loader  was  unable  to  successfully  reinitialize  HRC  after  load- 
ing a  network  device.  This  could  affect  the  use  of  the  svstem  utilitv 
...COX. 

NTL  —  *  WARNING  *  —  System  name  changed  to  'name'' 

The  system  name  specified  during  SYSGEX  does  not  match  the  node 
name  specified  during  NETGEN.  The  system  name  has  been  changed  to 
the  node  name  in  NETGEN  and  will  remain  so  until  the  system  is  re- 
booted. 
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14.9   TRi  Error  Messages 


TRI  displays  an  error  message  on  your  terminal  when  it  detects  one  of  the 
errors  described  below.  These  messages  reflect  operational  conditions.  While 
most  result  in  termination  of  the  trace  interpreter  task,  a  few  are  for  informa- 
tion only. 

TRI  —  All  frames  were  excluded  by  /LI  or  /CH 

(Informational)  There  were  no  frames  traced  on  the  lines  or  channels  that 
you  specified  with  the  /LI  or  /CH  switch. 

TRI  —  Cannot  open  input  file 

(Fatal)  One  of  the  following  conditions  exists: 

•  The  specified  device  does  not  exist. 

•  The  volume  is  not  mounted. 

•  A  problem  exists  with  the  device. 

•  The  specified  IJIC  does  not  exist. 

•  The  specified  file  does  not  exist. 

•  You  do  not  have  read  access  privileges. 

TRI  —  Cannot  open  output  file 

(Fatal)  One  of  the  following  conditions  exists: 

•  The  specified  device  does  not  exist. 

•  The  volume  is  not  mounted. 

•  A  problem  exists  with  the  device. 

•  The  specfied  UIC  does  not  exist. 

•  The  volume  is  full  or  the  device  is  write  protected. 

•  You  do  not  have  write  access  privileges  to  the  UIC. 

TRI  —  Command  I/O  error 

(Fatal)  The  system  returned  an  error  when  TRI  attempted  to  read  a  com- 
mand line. 

TRI  —  Error  closing  output  file 

(Fatal)  TRI  failed  to  close  the  trace-listing  file. 
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TRI  —  Error  reading  input  file 

(Fatal)  The  system  returned  an  error  when  TRI  tried  to  read  the  trace 
input  file.  This  could  be  caused  by  a  device  error  or  a  bad  block  on  the 
volume. 

TRI  —  Error  writing  output  file 

(Fatal)  The  system  returned  an  error  when  TRI  attempted  to  write  a  line 
into  the  trace-listing  file.  This  could  be  caused  by  a  problem  with  the 
device,  a  full  volume,  or  a  bad  block  on  the  volume. 

TRI  —  Failed  to  spool  output  file 

(Fatah  The  system  failed  to  spool  the  trace-listing  tile. 
TRI  —  Illegal  character  in  filespec 

(Fatal)  One  of  your  file  specifications  is  incorrect. 
TRI  —  Illegal  command  string 

(Fatal)  TRI  detected  an  error  in  the  syntax  of  the  TRI  command  string. 
TRI  —  Illegal  switch  or  switch  value 

(Fatal)  You  have  specified  an  invalid  switch  in  the  TRI  command  string, 
or  you  have  given  an  invalid  value  to  a  switch. 

TRI  —  Incompatible  switches 

(Fatal)  You  have  specified  an  illegal  combination  of  switches.  Check  that 
you  have  not  specified  any  switches  other  than  /SP  or  /  SP  with  the  /-IN 
switch. 

TRI  —  Input  file  is  not  a  trace  dump  file 

(Fatal)  The  input  file  you  have  specified  is  not  a  trace  dump  file  produced 
as  output  from  an  N'CP  SET  TRACE  command. 

TRI  —  Trace  file  is  empty 

(Informational)  The  trace  file  specified  as  the  input  file  is  empty. 
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14.10   VNP  Error  Messages 

VNP  —  Account  field  too  long 

The  account  field  is  limited  to  16  characters. 
VNP  —  Alias  not  in  system 

An  attempt  was  made  to  reference  an  alias  that  is  not  in  the  system. 

VNP  —  Attempt  to  reference  block  number  that  is  not  within  the  system 
image  file  block-number  BIAS:n  ADDRESS:m 

An  attempt  was  made  to  reference  the  specified  block  number,  which  is 
not  in  the  system  image  file.  This  error  is  often  caused  by  attempting  to 
top-down  load  in  a  system  that  is  greater  than  \'2-\K  or  by  building  a 
system  image  file  that  is  smaller  than  the  real  memory  size  while  top- 
down  loading.  I'se  CVE  to  disable  top-down  loading. 

VNP  —  CETAB  data  structures  are  inconsistent 

The  data  structures  in  the  Communications  Executive  configuration  file 
(CKTAB)  are  inconsistent.  Possibly  the  CKTAB.TSK  file  is  corrupt.  Per- 
form another  \ET(;p:\  to  obtain  an  uncorrupt  CETAB. TSK  file. 

VNP  —  Circuit  not  in  system 

The  specified  circuit  is  not  in  the  system. 

VNP  —  COMEXEC  symbol  missing  from  symbol  table  symbol-id 

The  specified  symbol  is  not  in  the  Communications  Executive  symbol 
table. 

VNP  —  Communications  Executive  load  failed 

V\P  could  not  successfully  load  the  Communications  Executive. 

VNP   —  Communications   Executive   symbol   table  file   open   failure 
error-code  filename 

The  Communications  Executive  symbol  table  file  ifHenamc)  failed  to 
open.  The  error  code  is  returned  by  the  operating  system's  file  services.  All 
the  network  files  must  reside  in  the  TIC  defined  by  the  NETCIC  in  the 
system  image  file.  Check  the  NETCK  in  the  svstem  image  file  bv  using 
the  VMR  SET /NElTrK^  command. 

VNP  —  Configuration  file  read  error 

VNP  could  not  read  a  record  from  the  CETAB  source  file. 
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VNP  —  Controller  number  too  large 

The  controller  number  on  the  line  identification  is  illegal. 
VNP  —  Error  parsing  file  name  —  filename 

The  file  name  of  the  operating  system  disk  image  file  is  invalid. 
VNP  —  Event  cannot  be  filtered 

This  message  indicates  that  the  ability  to  enable  or  disable  one  of  the 
specified  events  is  not  implemented. 

VNP  —  Executive  symbol  missing  from  symbol  table  symbol-id 

The  specified  symbol  is  not  in  the  Communications  Executive  svmbol 
table. 

VNP  —  Executive  symbol  table  file  open  failure  error-code  filename 

The  RSX  executive  symbol  table  file  ifilcnomc)  failed  to  open.  The  error 
code  is  returned  by  the  operating  system's  file  services.  The  system  image 
file,  its  symbol  table,  and  all  network  files  must  reside  under  the  same 

ric. 

VNP  —  Failed  to  close  system  image  file  error-code 

The  system  ii.nage  file  failed  to  close.  The  error  code  is  returned  by  the 
operating  system's  file  services. 

VNP  —  Failed  to  get  command  line 

\'NP  could  not  read  a  command  line. 
VNP  —  Failed  to  load  a  process 

VNP  did  not  successfully  load  a  process  that  was  marked  for  load.  You  can 
list  all  processes  to  find  out  which  process  did  not  load. 

VNP  —  Failed  to  load  a  system  line 

VNP  did  not  successfully  load  a  line  that  was  marked  for  load.  You  can 
list  all  lines  to  find  out  which  line  did  not  load. 

VNP  —  Fur-^tion  not  implemented 

An  attempt  was  made  to  execute  an  unimplemented  VNP  function. 

VNP  —  GEN  partition  spans  highest  >iock  allocated 

The  default  partition  GEN  spans  the  h.,  nest  block  allocated.  I'se  the  PIP 
command  for  copying  files  with  the  /H\,:n.  switch  to  enlarge  the  output 
file. 
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VNP  —  Illegal  event  code 

The  event  code  given  is  invalid. 

VNP  —  lllegai  executive  size  nnn 

The  executive  size  {nnn)  is  illegal.  This  is  probahly  caused  by  a  corrupt 
system  image  file. 

VNP  ~  Illegal  line  cost 

The  line  cost  must  be  in  the  range  of  1  to  1022. 
VNP  —  Illegal  multipoint  active  ratio 

The  multipoint  active  ratio  must  be  in  the  range  of  1  to  255. 
VNP  —  Illegal  multipoint  dead  ratio 

The  multipoint  dead  ratio  must  be  in  the  range  of  1  to  255. 
VNP  —  Illegal  node  address 

The  node  address  must  be  in  the  range  of  1  to  1023. 
VNP  —  Illegal  object  type 

The  object  type  numbers  must  be  in  the  range  of  1  to  255. 
VNP  —  Illegal  tributary  address 

The  tributary  addresses  must  be  in  the  range  of  1  to  255. 
VNP  —  Illegal  unit  CSR  address 

The  unit  CSR  address  is  invalid. 

VNP  —  Insufficient  space  In  template-processing  buffer  (TIVIP$$A  psecf) 
Current  size  is  n  bytes,  but  it  should  be  expanded  to  at  least 
m  bytes 

VNP's  processing  buffer  is  n  bytes  long,  but  it  requires  m  bytes  for  the 
configuration.  Edit  VNPGEN.CMD  and  extend  the  buffer  size.  Then  per- 
form another  task  build  on  VNP  and  try  again. 

VNP  —  Invalid  hello  timer  value 

The  value  specified  for  the  hello  timer  is  invalid.  The  value  must  be  within 
the  range  of  1  to  65,535. 

VNP  —  Invalid  line  identification 

The  line  identification  is  not  in  the  proper  format. 
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VNP  —  Invalid  node  option 

Certain  node  options  are  valid  only  on  the  executor  node,  while  others  are 
not  allowed.  You  must  verify  that  all  options  selected  are  valid  for  the 
node  specified. 

VNP  —  Invalid  parameter  grouping 

The  combination  of  parameters  specified  is  invalid.  For  example, 

NCP  SET  LOGGING  CONSOLE  EVENTS  2.0  CIRCUIT  DMC-O  NODE  A 

is  invalid  because  you  cannot  specify  two  entities  to  qualify  events  that 
are  to  be  logged.  You  can  specify  the  circuit  or  the  node,  but  not  both.  If 
you  want  two  entities  to  be  logged,  you  must  enter  two  separate  com- 
mands. 

VNP  —  I/O  error  accessing  system  image  file  error-code 

A  disk  I/O  error  occurred  when  VNP  accessed  the  system  image  file.  The 
error  code  is  returned  by  the  operating  system's  file  services. 

VNP  —  KMC  microcode  load  failed 

VNP  failed  to  load  the  KMC  microcode. 
VNP  —  Line  name  too  long 

Line  names  must  be  1  to  3  Radix-50  characters. 

VNP  —  Line  not  assigned  to  XPT  or  DLX 

An  attempt  was  made  to  access  a  line  that  is  not  on  a  network  communi- 
cations device  assigned  to  XPT  or  DLX. 

VNP  —  Line  not  In  system 

The  speciiied  line  is  not  in  the  system. 

VNP  —  Line  parameter  not  applicable 

The  line  option  is  valid  on  SET  NODE  requests  only  if  the  node  identifi- 
cation is  a  name. 

VNP  —  Maximum  controllers  limited  to  64 

The  maximum  controller  count  for  the  SET  PROCESS  request  is  limited 
to  64. 

VNP  —  Maximum  lines  limited  to  64 

The  maximum  line  count  for  the  SET  PROCESS  request  is  limited  to  64. 
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VNP  —  NETACP  must  be  "fixed"  in  RSX-11S  systems 

NETACP  is  not  fixed  in  an  RSX-llS  System.  Fix  NETACP  using  VMR 
before  starting  VNP. 

VNP  —  NETACP  not  instailed 

NETACP  is  not  installed.  Install  NETACP  using  VMR  before  restarting 
VNP. 

VNP  —  Network  buffer  pooi  is  too  smail 

The  network  buffer  pool  is  not  large  enough  to  load  the  system  software. 
You  will  have  to  use  \^MR  on  your  system  image  to  change  the  size  of  the 
network  pool  partition. 

VNP  —  Networl(  initiaiizer  not  instaiied 

The  network  initializer  (NTINIT)  is  not  installed.  Install  NTINIT  with 
VMR  before  restarting  VNP. 

VNP  —  Networic  pooi  partition  not  in  the  system 

VNP  could  not  find  the  network  pool  partition  as  specified  during  NET- 
GEN. 

VNP  —  Node  in  wrong  state 

The  node  is  not  in  the  proper  state  to  perform  the  requested  function. 
VNP  —  Node  name  too  iong 

Node  names  are  limited  to  a  maximum  of  6  characters. 
VNP  —  Node  not  in  system 

An  attempt  was  made  to  reference  a  node  that  is  not  in  the  system. 

VNP  —  Non-UMR-mapped  area  is  too  iarge 

The  non-UMR-mapped  portion  of  the  network  pool  is  larger  than  the 
entire  network  pool. 

VNP  —  No  part  of  GEN  partition  is  within  system  image 

The  default  partition  GEN  is  not  within  the  system  image.  I'se  the  PIP 
command  for  copying  files  with  the  /BL:n.  switch  to  enlarge  the  output 
file. 

VNP  —  Not  enough  contiguous  UMRs  to  map  network  pooi 

The  network  pool  needs  too  many  UMRs  to  be  loaded.  You  should  try  to 
reduce  the  size  of  the  network  pool. 
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VNP  —  NTINIT  must  be  'fixed  '  in  RSX-11S  systems 

NTINIT  is  not  fixed  in  an  RSX-llS  system.  Fix  NTINIT  using  VMR 
before  restarting  VNP. 

VNP  —  Object  not  in  system 

An  attempt  was  mac^e  to  reference  an  object  that  is  not  contained  in  the 
system. 

VNP  —  Object/remote  bloci(  allocation  failure 

There  is  not  enough  network  pool  or  dynamic  storage  space  to  allocate  a 
remote  name  block  or  an  object  block. 

VNP  —  Object  tasl(  name  too  long 

Object  task  names  must  be  1  to  6  Radix-50  characters. 
VNP  —  Open  failure  on  configuration  file 

VNP  could  not  open  the  CETAB  source  file. 

VNP  —  Open  failure  on  system  image  file  error-code  filename 

The  system  image  file  (filename)  cannot  be  opened.  The  error  code  is 
returned  by  the  operating  system's  file  services. 

VNP  —  Owner  process  name  too  long 

Process  names  must  be  1  to  3  Radix-5()  characters. 
VNP  —  Partition  name  too  long 

The  partition  name  must  be  1  to  6  Radix-50  characters. 
VNP  —  Password  field  too  long 

The  password  field  is  limited  to  8  characters. 
VNP  ~  PLB  allocation  failure 

VNP  was  not  able  to  allocate  enough  space  for  the  XPT  data  bases. 
VNP  —  Process  name  too  long 

Process  names  must  be  1  to  3  Radix-50  characters. 

VNP  —  Resource  error  trying  to  allocate  CCBs 

There  is  not  enough  dynamic  storage  space  in  your  system  to  allocate  the 
control  buffers. 
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VNP  —  Reverse  mapping  table  inconsistent 

The  reverse  mapping  table  has  been  corrupted. 

VNP  —  RSX-11M  system  pool  allocation  failure 

The  system  pool  is  empty.  Use  V'MR  to  increase  the  size  of  the  system 
pool. 

VNP  —  Supposed  system  image  file  not  actually  a  system  image 
filename 

The  indicated  tile  is  not  a  system  image  file. 
VNP  —  Syntax  error 

The  command  line  is  not  correct. 

VNP  —  System  Image  does  not  contain  a  GEN  partition 

The  default  partition  for  network  software  is  GEN.  The  system  image  file 
does  not  contain  a  GEN  partition. 

VNP  —  System  image  file  corrupted  because  VNP  was  terminated 
abnormally  filename 

A  previous  execution  of  VNP  terminated  abnormally  and  may  have  cor- 
rupted the  system  image  file  (filename).  Recopy  the  system  image  file 
before  restarting  VNP. 

VNP  —  System  image  must  be  extended  to  n  blocks  if  tlie  GEN 
partition  is  to  be  contained  within  the  image 

The  default  partition  GEN  is  not  within  the  system  image.  Use  the  PIP 
command  for  copving  files  with  the  /BL:n.  switch  to  enlarge  the  output 
file. 

VNP  —  The  Communications  Executive  data  structures  are  too  large  for 
VNP's  internal  buffer.  The  buffer  (CET$$A  psecf)  can  be  ex- 
panded to  2776  bytes  maximum  (from  the  currerit  i  bytes),  but 
this  configuration  needs  m  bytes.  This  error  is  re  recoverable 
without  source  modifications. 

VNP's  internal  buffers  cannot  accommodate  the  Communications  Execu- 
tive configuration  file  (CETAB).  Reduce  the  size  of  the  configuration. 

VNP  —  Too  many  object  task  copies 

A  maximum  of  63  object  task  copies  is  allowed. 
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VNP  —  Tributary  number  too  large 

Tributary  numbers  must  be  in  the  ran^'e  ot  1  to  2")"). 
VNP  —  UMR  block  allocation  failure 

There  is  not  enough  dynamic  storage  spare  to  allocate  a  I'MH  block. 
VNP  — -  Unable  to  dynamically  allocate  network  buffer  pool 

\'\P  could  not  allocate  enough  partition  space  to  load  the  network  pool. 
VNP  —  Unit  number  too  large 

The  unit  number  on  the  line  identification  is  illegal. 
VNP  —  Unspecified  error  during  CONFIG  file  scan 

\'N1*  could  not  successfully  parse  all  the  definitions  in  the  CP7rAB  source 

file. 

VNP  —  User  identification  field  too  long 

The  user  identification  field  is  limited  to  a  max   num  of  16  characters. 
VNP  —  XPT  channel  table  inconsistent 

The  XPT  channel  table  has  been  corrupted. 
VNP  —  XPT  data  base  not  allocated 

The  XPT  process  is  loaded  but  the  data  structures  are  not. 
VNP  —  XPT  process  not  loaded 

The  XPT  process  is  not  loaded. 


• 


v« 
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Appendix  A 

CFE,  NCP,  and  VNP  Command  Summary 


This  appendix  summarizes  the  full  command  sets  for  the  CFE,  NCP 
(RSX-  IIM/M-PLUS  and  RSX-llS).  and  VNP  utilities. 

Please  review  the  graphic  conventions  outlined  at  the  front  of  this  manual, 
especially  *ne  usape  of  braces  |  }  and  brackets  [  ].  These  conventions  are  used 
throughout  the  command  summaries  to  specify  parameter  selection  and  op- 
tionality.  Shaded  text  flags  commands  or  parameters  that  are  valid  for  PSI 
users  only. 

In  this  appendix  only,  red  ink  is  used  to  identify  NCP  commands  and  parame- 
ters that  are  RSX  system  specific.  All  CFE  and  VNP  commands  are  RSX 
system  specific. 
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A.1    CFE  Command  Summary 

All  CFE  commands  are  privileged. 


DEFINE    jCmcVlT  circuit-id 
|kNO\VN  riRCLITS 


(CHANNEL  channel-number] 

[COST  cost] 

[COUNTER  TIMER  seconds] 

[DTE  dte-addre88] 

1  HELLO  TIMER  seconds] 

[MAXIMUM  BROADCAST  ROITERS  numhrr] 

[MAXIMUM  DATA  byte-count] 

[MAXIMUM  RECALLS  retry-count] 

(MAXIMUM  WINDOW  block-count] 

[Ml'LTIPOINT  ACTIVE  actke-ratio] 

(NUMBER  dte-addreas] 

(RECALL  TIMER  seconds] 

[ROUTER  PRIORITY  nrmritx] 

service/disable) 

(^ENABLE  J 
STATE /off  1] 

TRIBUTARY  trih-addrcss] 
"USAGE /incoming  11 
\0UTG0INGjJ 


DEFINE       EXECUTOR 


:ADDRESS  node-address] 

[BROADCAST  ROUTINO  TIMER  seconds] 

iHOST  node-address] 

[IDENTIFICATION  id-strinfj] 

[MAXIMUM  ADDRESS  node-address] 

■MAXIMUM  BROADCAST  NONROUTERS  numher) 

[MAXIMUM  COST  number] 

[MAXIMUM  HOPS  number] 

[MAXIMUM  LINKS  number] 

[MAXIMUM  NODE  COUNTERS  number] 

[NAME  node-name] 

[ROUTING  TIMER  seconds] 

[SEGMENT  BUFFER  SIZE  number] 

SUBADDRESSES  range] 

VERIFICATION  [STATEj/oFf] 

l«^'  J. 
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DEFINE    June  line-id        ' 
\KNOVVN  UNESJ 


CFE 


irONTROLLERl  CSR  csr-address] 
TONTROLLER  jLOOPBArKV 

\normal   J 

^COUNTER  TlME^seconds] 

Dl'PLEX  /fill" 

Ihalf^ 

HOLDBACK  TIMISR  miUiseconda] 
[MAXIMUM  DATA  byte-count] 
(MAXIMUM  RETRANSMITS  retry-count] 
[MAXIMUM  WINDOW  block-count] 

iMl'LTIPOINT  DEAD  dead-ratio] 
[PRIORITY  harduan'-priontx] 
[RETRANSMIT  TIMER  milliaeconda] 

SPEED  haud-ratt'] 

STATE     r CLEARED 
SOFF 

Ion 

il'NIT  CSR  csr-nddress] 
[VECTOR  lector-address] 


DEFINE 


< 


KNOWN  LOGC.INC, 
LOGGING  CONSOLE 
LOGGING  FILE 
LOGGING  MONITOR 


>    . 


/events  list 
\kNO\VN  EVENTS 
^  STATE  fOFF" 


DEFINE  MODULE  X25-ACCESS    DESTINATION  dest-name    NUMBER  dte-address 


DEFINE  MODULE  X25-PROTOCOL 


fDTE  dte-addresa 
KNOWN  DTES 


1 


(CHANNELS  list] 
(COUNTER  TIMER  seconds] 
(LINE  line-id]  y 

MAXIMUM  CIRCUITS  count]  [ 
'STATE /off  Tl  I 

W  ]\  J 


{iGROUP  group-name     (DTE  dte-addresa]  1 

KNOWN  GROUPS       [NUMBER  group-number] } 
(TYPE  BILATERAL)        J 

[CALI.  TIMER  seconds] 
[CLEAR  TIMER  seconds] 
(DEFAULT  DATA  byte-count] 
[DEFAULT  WINDOW  block-count] 
[MAXIMUM  DATA  byte-count] 
(MAXIMUM  CLEARS  count] 
[MAXIMUM  RESETS  count] 
[MAXIMUM  RESTARTS  count] 
[MAXIMUM  WINDOW  count] 
[RESET  TIMER  seconds] 
[RESTART  TIMER  seconds] 
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CFE 


DEFINE  MODl'LE 


•.     JX2o-SERVEK 
\X29-SERVER 


[C'OrN  TEH  TIMER  srcnnd.sl 
IMAXIMI  M  CIRCUITS  count] 


DESTINATION  dest-namc 
KNOWN  DESTINATIONS 


CALL  MASK  hcx-taluv  ] 
CALL  VALUE  hex-calutj 
(jROl'P  firoup-nnmc] 
(NUMBER  dtc-address] 
[OBJECT  <>hj(rt-id\ 
(PRIORITY  priority] 
[SIBADDRESSES  rnnfH'] 


PKKINK  \<'I)F.  'luilr-nl 


I)I,\(;N()>riC  VU.K  ii!r 

01  Ml'  ADDHKSS  (iddr,:y 

in   \\\'  COl'M    'umihrr 

DIMI'  FiI.K;r, 

HAI{|)\VAI<K  AI)1)HKS>  E  addrrss 

lit  )S  r  ni>d>'-id. 

LOAD  FlIJ-:;;'. 

NAMK  •:   •;.    -;;■•;. 

SKCoMiAin'    I.OAOKK  /:■  . 

>KK\i(K  ciHi  I  re  .inuit-id: 

SKHXK  K  hK\l(K  ;        .;■,;„ 
^KHNKK  \(il)K  \KH>I(tN     ri'llA>Klir 

\l'MA>Kl\ 
>Kini(K    l'A>>\\()KI) /.u»i.  .-/u. 
TKKMAin    (.oAhKH  /,wV-I 


I)i:ki\f.  ()H.if(  t 


.pr-i  '•(!• 


|siN{;i.KJ 
\ A.MF  '^u'l't -nnnu 
iSFH    fliFKAI  l.l] 
\L(»(;I\       j 
\FHIF1(A1'I()N    r!Sr>l'F( 

OFF 
ON 


I)FF1.\F      fl'Hoi  F 


>> 


KNOWN  l'f(0(F>SFS    r 


MAXIMIM  CoN'rHoI.FFR.^ 
MAXIMIM  1,1NF>  r,uMi/„/. 
"STATF    fci.FAKKI)' 


•(,'(,' 


DKFINK  ^^^■!FM 


l.AKoF  HI  FFFH  >1/F  'vj'nh.^ 
ri.oiATlON      fFlH.slFn 
L  \ToI'1)0\\N^ 

MAXIMIM  'd.\TK()[.  HI  KFFHS  numh,r 
MAXIMIM  I.AHCF  HrFKKHS  numhrr. 
MAXIMFM  >MA1.I.  HlKKFl^s  numhrr 
MINIMI  M  KFCFIXK  BFFFKHS  numh,r, 
I'OOI.  HM'F  AHFA  hxtv-i-nunt. 
I'OOI.  NAMF  j)nnl.namr. 
l'()Ol.  FAHirrioN  nartition-narj}. 
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CFE 


KXiT  inmjKi 


HKI.H  ic()mmand][c()mpt)rn'ntt)f)v 


KILL 

LIST      rCMKCriT  vinuit-id 
|KNt)\VN  (IRCriTS 

LIST  KXHriTOH 


LIST     JLINK  imr-ui 

1  KNOWN  LINKS 


LIST 


r 


< 


KNOWN  L()(;(;iN(; 
L()(;{;iN(;  console 

LOCO  I  NO  FJLK 
LOOOIN{i  MONITOR 


UST  MODULE  X26-ACCESS    /dESTINA'i  .ON  de8t-name\ 

\KNOWN  DESTINATIONSJ 


UST  MODULE  X25-PROTOCOL 


[/DTE  dte-addre»8\ 
J  \KNOWN  DTES  J 

/group  group-name\  I 
\KN0WN  GROUPS  J  J 


LU 

UST  MODULE     rX25-SERVERl     /DESTINATION  A  vt-wmel 

\X29-server/  \known  destinations/ 


LIST     JnoDK  nnd.'-id       1 
I  KNOWN  NODKS  J 


LIST      [OH-IFrT  f\p.  -rod. 
KNOWN  ()B.IK(TS 


LIST      f  PHOOKSS  pn,n'.».nam> 
\known  PROCKSSKS 


LIST  SYSTKM 


PURGE     (cmCUTT  circuit-id   \      COUNTER  TIMER 

\known  circuits/ 


PURGE    /line /in* 
\KNOWN 


UNES/ 


COUNTER  TIMER 
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CFE 

PIHCK     fKNOWN  lAHU'.lNC. 
LOCCINC.  CONSOI.K 

K()(;(;iN(;  kilk 

l.OClllNC.  MOMIOH 


ALL  FAKN'IS 
KVKNTS  list 
KNOWN  K.VKNl'S, 


PURGE  MODULE  X26.ACCESS    /DESTINATION  dest-name  \   ALL 

i  KNOWN  DESTINATIONS  f 


PURGE  MODULE  X26-PROTOCOL  f/DTE  dfe-addrm\       /ALL  \ 

\KNOWN  DTES  /       ]^COUNTER  TIMER/ 

j  /group  group-name\    ALL 
II KNOWN  GROUPS  / 


PURGE  MODULE   I'X25-SERVER1 


{ 


X29-SERVER/ 


inHCK 


KNOWN  NODKS 


COUNTER  TIMER 
/destination  destname  \  f  ALL 

\known  >esttnationsJ[^ 


:all: 

DIAC.NOSriC  FILKi 
.DlMl'  ADDHKSS 
iDlNH' COINT: 

[DiMP  file; 
:hahi)Wahk  addrkss; 
;h()st 
•load  filk 

:SKCONnAHV    LOADKRll 
iSKHVlCF.  (  IHCl  ITj 
;SKHV1('K  DKVICKl 

;:skhvick;  password! 

'i-KRIIARV   I.OADKR:: 


|kNOWN  OB.IKC  is 
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A. 2    NCP  Command  Summary  (RSX-11M/M-PLUS  Systems) 

NCP  commands  and  descriptors  that  are  supported  by  RSX-llS  are  summa- 
rized in  a  list  following  this  one. 

If  you  specify  ALL,  you  cannot  include  any  other  parameters. 

*  =  Command  cannot  be  executed  with  the  TELL  prefix. 

P  =  Privileged  NP  =  Nonprivileged  (SCOPE  is  always  privileged.) 


P  CLK.-XH     (\\. 

NP  <  AI. 

NP  I  K\( 


J.  AI.iASKS         ]  PSCOPK     f(;L()HAI. 
.\:\>  uluis-namc    >[  n'KKMlNAl.  N 

SOWN  A  1. 1  ASKS  J 


rm-id 


CLEAR    /circuit  arcuit-id  \    COUNTER  TIMER 

\KNOWN  cmcurrsj 


CLKAK  KXKdTOH 


;hosti 

kkckivk  !>assw()hi); 

I-HANSMir  PASSWOFiD, 


NP    *  CLEAR  KNKCrTOR  NODF 


CLEAR 


CLEAR 


LINE  Uru'-id 
KNOWN  LLNES 


Tall  ] 

\COUNTER  TIMER] 


KNOWN  LOClOINCx 
LO(;OLN(;  CONSOLE 
LOOC.LNC;  FILE 
LO(;(;iNC.  MONITOR 


[NAME! 

fALL  EVENTS 
EVENTS  /;,sf 
KNOWN  EVENTS 


'^CIRCCIT  nrruit-id 
LINE  linr-id 

MODULE  fX25-PROTOCOL^ 
^  <X26.SERVER       ^ 

LX29-SERVER 
LNODE  node-id 
SINK    fEXPXlTOR     ] 
i  NODE  nodv-idj 


I 


CLEAR  MODULE  X25-ACCLSS   fALL  DESTINATIONS        ^    flSCOPE)  /GLOBAL 

<  DESTINATION  dettname  V    [  1  TERMINAL  term- 

Lknown  destinationsJ 

CLEAR  MODULE  X25PR0TOCOL  f/DTE  cf<e-arfdrw»l     /ALL  11 

\KNOWN  DTES  J     "[COUNTER  TIMER  J  I 

/group  group-nameX  ALL 

\known  groups  / 


-}] 


CLEAR  MODULE   /X26.SERVERl    I    COUNTER  TIMER 

1  X29-SERVER  J  J 

'S  /destination  deat-name  1 
MkNOWN  DESTINATIONSJ 
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NCP 


P  CLKAH  NODK  nndr-td     (cIHCVVyX 

\NAMK     J 


P  CLKAH     JoH.IKCr  fNp.' .«(/,    1     Al-1, 

1  KNOWN  OH.IKCTS  ( 


P  n.FAR  PHOCKSS  proc.'.s,s-rjnmr 


P       •  (^I.KAR  SVSTKM 


P         CLEAR  TRACE   J  USE  line-id      \ 

\ACTIVE  LINES  J 


NP      •  KXIT 


NP      *  HKl.P  Icommnndlliomponent-type] 


KMX-DUMP    LINE  line-id  [FILENAME  file] 


LOAD    NODE  nudt'-id 


iADDRP:SS  node-address] 

[FROM  file] 

[HOST  nude-id] 

[NAMF^  nade-nome] 

[PHYSICAL  ADDRF:SS  K-address] 

[SECONDARY  [LOADER!  file] 

SERVICE  DEVICE  deuce-type] 
"service  node  VERSION  J  PHASEIlH 

\PHASEIVJ 

[SERVICE)  PASSWORD  passu  urd] 
[TERTIARY  [LOADER]  file] 
[VIA  circuit -id] 


LOAD  VIA  circuit-id 


[ADDRESS  node-address] 

[FROM  file] 

[HOST  node-id] 

[NAME  node-name] 

[PHYSICAL  ADDRESS  E-address] 

[SECONDARY  [LOADER!  file] 

[SERVICE  DEVICE  devtce-txpe] 

fSERVICE  NODE  VERSION  fPHASEIII 

L  \PHASEIV 

[[SERVICE!  [PASSWORD  password] 

[TERTIARY  [LOADER]  file] 


]] 
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NCP 


LOOP 


LINE  line-id 

riRCriT  circuit-id 


HELPfFlLL 

i  Hh:CVA\K 

Ltransmi 


TRANSMIT 
PHYSICAL  ADDRK 
ASSISTANT  PHY 
NODE  E-nodv-name 
ASSISTANT  NODE  E-node-nam 


:ESS  E-addrvss  ]] 

SICAL  ADDRESS  Eaddrvssj ' 

J 


[COrNT  count] 
LEN(;TH  Um^th] 


NP         LOOP     [node  nodc-idlacc- 

[expxitor 


can 


infn]\ 


[COUNT  count] 
LENCITH  length] 
WITH    fMIXED    y 
<  ONES       V 
LZEROESJ 


WITH 


fMIXED    ^ 
ONES 
L ZEROES , 


NP 


SET       ALIAS  alia^-name     DESTINATION 


SET      rCIRClIT(/rru/Y-/d   \ 
l^KNOWN  CIRCIITSJ 


.■  dest-nudc    HSCOPEi    fciLOBAL  Y\ 

[  [terminal  ti'rm-idjj 


[COST  cost] 

(COUNTER  TIMER  seconds] 

IHELLO  TIMER  seconds] 
[MULTIPOINT  AL'TIVE  active-ratio] 

"owner  JdlxI 

IXPTf 
'SERVICE   JDISABLETI 

[enable  J 
■^tate  roFF 

^SERVICE  J 
■TRIBUTARY    trib-address] 


SET  EXECUTOR    [HOST  node-id] 

RECEIVE  PASSWORD  passu  ord] 
[ROUTING  TIMER  .seconds) 
[SEGMENT  BUFFER  SIZE  number 
"STATE    rOFF 
ON 

,SHUT 
[SUBADDRESSES  range] 
[TRANSMIT  PASSWORD  passuord] 
[VERIFICATION  [STATE]    fOFFV 

[on  /J 


,  1 


NP      •  SET  EXECUTOR  NODE  node-idiacc-con-info] 
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NCP 


SKT  KNOWN  LINES 


Loading  options: 


("state  /off 


{o^}] 


(ALL) 

[DKAD  TIMP:R  mi7//.s<.(OMd.sl 
DP:LAY  timer  milliseconds] 
'iH'PLEX    rpl'Ll/ 

[half^ 

"l.OCAriON     jFIHSIFir 
riOI'DOWN 


Loaded  options: 


fCOUNTER  TIMER 


OWNKH     J  ULX 
IPU 


."> 


aecondM] 


SET  LINE  line-id 
Loading  options: 


fSTATE  foFFV] 


Loaded  options: 


ALL] 

CONTHOLLKH   C^H  csr-address] 
DEAD  TIMER  milliseconds] 

[DELAY  TIMER  milliseconds] 

"duplex    fFlLLV 

\halfj 
uocation:   rFlHSTKir 

I'rOPDOWN 
"MrLTIPOlNT  DKAD  draa-ratm] 
PKIOIiirV  harducire-prinntyi 
INIT  ("SR  vsr-address\ 
[VECTOR  irrtor-oddress] 

CONTROLLER  /lOOPBACkI 

\normal    J 

(COUNTER  TIMER^»ecom<«] 

"owner   /dlxV 

IPU    I 


SET     r  KNOWN  LOOGINCi 
LOCiGINC.  CONSOLE 
LO(iOIN(;  FILE 
LO(iGING  MONITOR 


r 


NAME  name 
STATE    fOFF 

Ion 


r 


EVENTS  list 
KNOWN  EVENTS 


L-^ 


-I'N 


r CIRCUIT  circuit-id 
LINE  line-id 

MODULE  fX26-PROTOCOLl 

<X25-SERVER      } 

lX29^SERVER     J 

<.N0DE  node-id 

SINK  /executor     \ 

\nODE  node-id  J 


> 


-/ 


SET  MODULE  X25-ACCESS      DESTINATION  deatname   NUMBER  dte-address  - 


[. 


^^^^™       {terminal  term-id  J  J 
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NCP 


SET  MODULE  X25-PROTOCOL 


JDTE  dte-addresii\ 
1  KNOWN  DTES  f 


/group  group-name] 
\KNOWN  GROUPS  J 


[COUNTER  11MER  seconds]  ' 

[state 


[STATE    fOFF   ^'] 
jON      I 
IshutJJ 


[! 


DTE  dte-address 
NUMBER  group-number 
[TYPE  BILATERAL) 


.] 


SET  MODULE  X25-SERVER 


COUNTER  TIMER  seconds] 
STATE 


fOFF    ^ 
]0N      \ 

LshutJ_ 


DESTINATION  dest-name 


I  )BJECT  object-id 
CALL  MASK  hex-value  ] 
CALL  VALUE  hex-value] 
[GROUP  group-name] 
[NUMBER  dte-address]  - 
[PRIORITY  priority] 
[SUBADDRESSES  range] 


SET  MODULE  X29-SERVER 


r  COUNTER  TIMER  seconds 

DESTINATION  deat-name    OBJECT  object-id 

CALL  MASK /lex-fa/ue] 
CALL  WALVE  hex-value] 
[GROUP  group-name] 
[NUMBER  dte-address] 
[PRIORITY  priority] 
(SUBADDRESSES  range] 


P 
P 


SF;I"    node  nodr-namr      C'lHC'lTI"  cinuit-id 
SF.T    NODP:  nnd,-id      NAMK  nndr-namr 


SET  OH.IECT  .'\pi--coa. 


'()l'Ii'>    (nun:  her 
1S1N(;1.K 


NAME  I'hjcct-namr.. 

ISKH    JnFFAriTl 
|l.()(iIN       J 

IAKHIFICAIION    flNSI'FC'I' 

OFF 
ON 


SFl   l'KO('K>S  process-name 


MA. 

I-OCAllON     rFlK>[Fri    ' 
[top  DOWN  J 
'MAXIMCM  CONTHOFFFRS  euunt] 
MAXIMFM  FINES  count- 
i'AH'ITriON  ixirtitinn-nami'. 


P 


SET  SYSTEM 


SET  TRACE     TLINE  line-id      \    (BUFFER  SIZE  block-count]  fSTATE    fOFFTl 
INACTIVE  UNESJ    (FILE  file]  [  \^0N  J  J 


Summary  of  CFE,  NCP,  and  VNP  Commands       A-11 


NCP 


NP         >H(>W      r.M.l,  ALIASKS 

Al.I.-VS  i//(f/>-M(j"i' 
KNOWN  AI.IASKS, 


SlMMAin 


SCOlMv  fCLOHAI. 

VIKHMIN  \I.  urm  ui 


TO  fih 


NP         SHOW 


CWiCVVV  nnuit  id 

A("ri\K  ciHcri'is 
KNOWN  CIHCI  ITS 
SKiNlKlCANr  CIKCI  ITS 


\ 


CHAHACrKHIsriCS" 
COINIKKS 
SI'ATl  S 
SIMMAHV 


TO/;/. 


NP 


sfiow  KXK(  rroK     r 


'CHAHACrKHIS  TICS' 
COrNIKHS 
SI-ATIS 
SIMMAHV 


TO  ///<■! 


NP         SHOW     fUNK  /;n.  ■,(/ 

ACTIVK  IJNKS 
KNOWN  LINKS 
SI(;NIKICANr  I.INKSl 


fTHAKACIKHIsriCS 
IcorNTKHS 

iSiAirs 

IM  MMA.HV 


'()  ///»• 


NP         SHOW 


r  ACTIVK  i.()C.(;iN(; 
KNOWN  LOOOINd 
LOOdINC  CONSOLK 
!.()(;( iINC  KII.K 
I.OC,(;iN(;  Mt)NTTOH 

'^SKINIKICAN'T  LOOOINO 


"N 


CHAKACTKHISTICS' 
KVKNTS 
S'TATl  S 
SCMMAHV 


■'TO/V/r-! 

JKNOWN  SINKS 
(sink  NODK  wxU-hI 


NP 


NP 


NP 


SHOW  MODULE  X25-ACCESS     TALL  DESTINATIONS        ^  rrCHARACTERISTICSV] 

\  DESTINATION  dest-name  \  \SUMMARY  f 

Lknown  destinationsJ  l^  -'J 


[ 


ISCOPE)      rCLOBAL 

{terminal  ferm 


»}] 


rro  file] 


SHOW  MODULE  X25-PROTOCOL  ffDTE  dte-addressr\      ^rCHARACTERISTICS^"^    (TO  file] 

\  KNOWN  DTES  H        J  COUNTERS  L 

L*^  ^  J      M  SUMMARY  jj 

YgROUP  group-nameX\  rrCHARACTERISTICSH      (TO  file] 
[KNOWN  GROUPS   M    [SUMMARY  H 

RfcHARACTERISTICS")"!       (TO  file] 
STATUS 
SUMMARY 


}] 


SHOW  MODULE   rX25-SERVER\    fpESTINATION  dest-nameT\  nfCHARACTERISTICSll  (TO /*7c] 
|X29-SERVERj     [KNOWN  DESTINATIONS^    [SUMMARY  H 


CHARACTERISTICS^" 
COUNTERS  I 

STATUS  f 

SUMMARY  J 


[TO  m 
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NCP 


\1'        SHOW     r\n\)V.  ni>di-i(i 

A(   ri\K  NODKS 
AD.IACKM    NODK.s 
KNOWN  NODKS 
LOOP  NODK.s 
vSKiNIKKAN T  NODK^ 


< 


nilAHACIKHlSTK  S"n 

col  NIKHS 
^  sTATrs 
SIMMAHY 


I 


TO///.' 


Nl' 


Nl' 


>[jo\\      ;OH.lK(  T  '\/..  ,Mf/,'  ' 
KNOWN  OH.IKCTS 


1' 


ACII\  K  l'HO<KSSKS 
KN(  iW  N  I'HOCKSSKS 


l>r\i\iAin 


'>  lA  11  > 
^slMMAK^ 


( ) 


ro  /' 


Nl' 


•^HOU   ^N>1  KM 


ft 


^<HAi{A<rKHI>TI( 
(  OINTKIO 

siAirs 

S\  \]\].\H\ 


( )  ■   . 


NP        SHOW  TRACE 


TSTATUS     Yl   [TO  file] 
[SUMMARYJ 


Nl'  IKl.l,  '{"di  -ici[(m-i  "ti.ini'<[  rn  p-<(inim(in(i 


IKKiCKH  NODK  nndr-ul 


\  lA  (  tri  lilt -1(1 

I'HVSICAl.  ADDHKS>  /•.  „d(ir,^. 
:  >KK\li  K    I'ASSWORD  p(i>su<,rd. 


TH1(.(.KH  \IA  •irnat-id         I'UVSKAI,  ADDKK.ss  E-nddn-s^, 

.SKHMCK   I'ASSWORD  passu, ,rd] 


y.y.Hi)    (cuicivy  <irruit-id  \  cointkhs' 

KNOWN  ("IHCIITS  r 


/.KHO  KXKCI   TOR   CorNTKRS 


P  ZKRO     jMNK  //>;.■■;(/        \    COlNrKRS 

KNOWN  LINKS  I 


ZERO  MODULE  X25-PROTOCOL     fDTE  dte-adiress\    (COUNTERS] 

[known  DTES 


ZERO  MODULE 


rX2o-SERVERl     [COUN 
\X29-SERVERJ 


(COUNTERS) 


P  ZKRO      ISODK  nndr-id       1     CorNTKRS] 

\known  nodksJ 

P  ZEKOs^SIKM    col  NIKKS, 
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A. 3    NCP  Command  Summary  (RSX-11S  Systems) 

The  following  commands  are  supported  b\  the  RSX-llS  \CV  and  the  HSX- 
IIS  NK^E.  The  privileged  (P)  and  nonprivileged  (NP)  classifications  apply 
only  to  commands  sent  from  a  remote  system  to  an  KSX-llS  NICK  that  has 
been  built  with  a  privileged  password.  All  commands  can  be  initiated  both 
locallv  and  remotelv  unless  one  of  the  followinu  restrictions  is  indicated: 


+      Command  cannot  be  executed  by  the  HSX-llS  NCP. 
i:  ^^  Command  cannot  be  initiated  fr(»!n  a  remote  node. 


NP  LOOP      rXODF  nndr.t(i:acc-c<m-infn: 

\F.\K(1   roH 


COINT  <nunt'. 
LF.NOTH  /.7!t','/r 
WITH    fMIXKI) 
ONK.S 
ZKHOK.'^ 


SKT  CIHCirrf 


■inuit-id    .SIATK     foFFl 

|oN  I 


P 
P 


SFT  KXKCrroH  \\{)>T  nndr-ui 

i  SKT  LINK  <-ONTHOFFKH  /l.OOPHArK 

\OKM.-\L 


SKT  I.OC.C.INC  CONSOLK      STATK    lOFF 

ION 


NP 


SHOW 


I     A 


IHCri'I"  vircuit-ni    ^ 

("nvK  ciF^criTs 

KNOWN  CIRC  TITS 


{■OlNIKHS 
STAITS 
LlSlMMAin 


NP 


SHOW  KXKcrroH 


(  HAHAC'IKRISTICS"^ 
COrNIKHS 
<  STAITS 
l>rMMAHY 


NP  SHOW    r     FINK  linr-id 

^  ACnVK  LINKS 
-  KNOWN  links! 


^COINTKH^ 
STATIS 
MMNLXHV 


NP 


SHOW  LO(;oiN(;  consolk  statcs 


NP  SHOW    f     S()\)V.  nndrid 

ACriXK  NODKS 
KNOWN  NODKSl 


(  HARACTKRISTICS 
COINTKRS 
<  STATLS 

s^^L\lAR^ 
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NP         SHOW  sV<TKM 


'CHAHACTKHISTfCv  "^" 
COINTKHS 
STAns  > 

SIMMXRV 


ZKRoT  CIRCriT  </r,u/r(rf^ 
KXEriTOR 
^      LINE  lim'-ici  > 

t  NODE  nociv-id 
SVSTKM 

N  rciRniTs^ 

<  LINES         ^ 

Lnodes    J 


[COrNTERS; 


P       +    ZERO  KNOW 


[COINTERS] 


NCP/S 
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A.4   VNP  Command  Summary 

All  VNP  commands  are  privileged. 

If  you  specify  ALL.  you  cannot  include  any  other  parameters. 


CLKAR     f  ALL  ALIASES 

ALIAS  (ilias-namc 
KNOWN  ALIASES 


"srOPEl    n^LOBAL  \1 

VrERMINAL  trrm-idj] 


CLEAR  EXECITOR  [HOST] 

[RECEIVE  PASSWORD! 
[TRANSMIT  PASSWORD) 


CLEAR 


CLEAR 


{t 


INE  line -id 
KNOWN  LINE 


\     ALL 


<NOWN  LOCOINC,    ^ 
X)(;(;iNG  CONSOLE 
.OC,(^.IN(;  FILE  > 


K 

LOC.C.INC,  MONITOR 


J 


[NAMEi 

All  EVENTS 
EVENTS  list 
KNOWN  EVENTS 


V. 


CLEAR  NODE  nodi'-id     fCMRClIT 

|name 


CLEAR      fOB.IECT  typr-codr   \   [ALL] 
KNOWN  OBJECTS  f 


V 


'LINE  linr-id     \ 
NODE  n(.  .c-idf 
\SINK  d^XECCTOR  "^ 

NODE    (node- id '\ 
|SH0ST  r 


JJJ 


CLEAR  PROCESS  process-name 


CLEAR  SYSTEM 


EXIT 


HELP  xommandWcomponent-type] 


SET      ALIAS  alias-name    DESTIN 


STINATION  de.sf-noc/c   [[SCOPE]    fOLOBAL  ^"1 

[  JTERMINAL^erm-id  M 


SET     [CIRCUIT  circuit-id    ] 
1  KNOWN  CIRClITSi 


[COST  cost] 

[HELLO  TIMER  seconds] 
[MULTIPOINT  ACTIVE  active-ratio] 
OWNER   [DLX\] 
(XPTJJ 
SERVICE/"  DISABLE \] 
\  ENABLE  /J 
STATE     [OFF 
<  ON 

[service 

[TRIBUTARY  trih-address] 
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VNP 


• 


SET  KXECITOR 


[HOST  n„dt'-id] 

[RECEIVE  PASSWORD  pasKUord] 
[ROITINC;  TIMER  ^amds] 
(SEdMENT  BIFFEK  SIZE  number] 
("STATE    [OFF 

U)N     rjFIXED 

L  I       [\rN  fixed] 

[TRANSMIT  PASSWORD  passu'ord] 
[VERIFICATION  [STATE!    fOFF)] 

I  \«-^-    jJ 


SET  KNOWN  LINES 


Loading  options: 


SET  LINE  line-id 
Loading  options: 


[ALLl 

[DEAD  TIMER  milliseconds] 

DELAY  TIMER  milliseconds] 

DIPLEX    fFlLLV 

[half/ 

[■[LOCATION;  FIRSTFIT! 


[ALL! 

[[CONTROLLER!  CSR  csr-address] 
[DEAD  TIMER  milliscamds] 
[DELAY  TIMER  milliseconds] 

R:)CPLE 


EX    [FrLLV 

[half/ 


IT] 


[LOCATION!  FIRST 
[MILTIPOINT  DEAD  dead -ratio] 
[PRIORITY  harduare-pnont\ ] 
[UNIT  CSR  csr-address] 
[VECTOR  Lector-address] 


SET    fKNOWN  LOGGINCi 
LO(;C,IN(i  CONSOLE 
LOC.GING  FILE 
LOGGING  MONITOR 


NAME  name 
STATE    rOFFl 

(on  I 

^EVENTS  list 
KNOWN  EVENTS 


1 


SET  MODULE  X25-SERVER    STATE 


/off\ 

toN/ 


.} 


fLINE  line -id 
^NODE  node-idj 
SINK  rEXEClTOR 
<  SODEfnode-id 
L  \$H0ST. 


n  "s 


> 


J  _ 


SE:T       node  node-name    CIRCL'IT  circuit-id 


SET        NODE  node-id     NAME  node-name 
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VNP 


SET  OaiECT  type-code         ["COPIES 


i^S     Cnumher  ^  "j 
[siNCLb^lJ 
[NAME  ohjeet-name] 

rrsER  ri)EFArLT\] 
I  iLor.iN     ;| 


[ 


ERIFICATION 


riNSFEfT 
OFF 
ON 


SB:T  process  pn,cess-rwme    [ALL] 

[[LOCATION!  fFIRSTFir  \] 
[  VTOPDOWN/J 


[MAXIMIM  CONTROLLERS  count] 
[MAXIMIM  LINES  iount] 
(PARTITION  partition-name] 


SET  SYSTEM  'TOP] 

SHOW    f  ALL  ALIASES 

ALIAS  alias-name 
KNOWN  ALIASES! 


'characteristics' 
si;mmary 


[SCOPE]    rOLOHAL 

{terminal  term-id 


} 


SHOW     rciRCl'IT  circuit-id  ] 
I  KNOWN  CIRCCITSj 


SHOW 


'CHARACTERISTICS" 
SUMMARY 


SHOW       EXECITOR  [fCHARACTERISTICS 

[i  SUMMARY 


}] 


LINE  ti 
KNOW 


ne-id       \       r  fCHARACTERISTICS  Y 
N  LINESJ      [[summary  j 


SHOW    TKNOWN  LOGGING    ^ 
LOGGING  CONSOLE  I 
LOGGING  FILE 
LOGGING  MONITOR 


'CHARACTERISTICS^"! 
EVENTS 
SUMMARY 


)J 


[KNOWN  SINKS        V 
i  SINK  NODE  node-id  r 


SHOW     MODULE  X25-ACCESS    fAU.  DESTINATIONS        ^  r/CHARACTERISTICS\1 

<  DESTINATION  dest-name  IKSUMMARY  fj 

[known  DESTINATIONSJ   '^  ^ 

riSCOPEl    rOLOBAL  V] 

[  [terminal  term  id jj 


SHOW  MODULE  X26-PROTOCOL 


'(UTE  dte'addre88\ 

[known  DTES  J 

/group  group-name\ 
J\KNOWN  GROUPS  jj_ 


rrCHARACTERISTICSri 

[[summary  jJ 


SHOW  MODULE    rX25-SERVER\      f  fDESTINATION  dest-nameY]       f /CHARACTERISTICS \1 

•[x29-server|    [[known  destinationsH     [[summary  jJ 
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VNP 


SHOW    f  NODK  ni>dr-id 

AD.IACKNT  NODKS 
KNOWN  NODKS 
LOOP  NODKS 


SHOW      rORIKOT  (\p,--cnc{r  ^ 
1  KNOWN  ()H.JKOTS| 


(>iARA(^TKHISTI{'S- 
SIMMAHV 


'OHARACTKHISTIOS 
SIMMAHY 


SHOW      fPHOCKSS  proct'ss-rutmA      ISI'MM 

[known  prookssks  I 

SHOW  SVSTKM  f"  fcHARAOTKRISTIOS^] 
L\SIMMARV  n 


ARY! 
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Appendix  B 
Object  Type  Codes 


Table  B-1  defines  valid  object  type  code  values  and  describes  their  process 
type  for  network  management.  The  values  are  expressed  as  decimal  byte 
values.  Digital  reserves  the  right  to  add  object  types  v.t  to  make  changes  to  the 
descriptor  formats  used  by  the  object  types. 

Table  B-1:    Object  Type  Codes 


Object 
Type  Code 

0 

1 

2-4 
r> 

B-14 

ir, 

17 
18 

19 

20 

21-22 

2M 

24 

2.'i 

2H 

27  41 

42 

4:^-H2 

64-127 
128-25.T 


Process  Type 

General  task,  user  pro^jram 

File  Acces.s  Listener  -  F.ALT) .AP,  Version  1 

Reserved  tor  DKCnet  use 

RSX-llM  Task  Control  -    Version  1 

Reserved  for  DFCnet  use 

RSX-llM  Task  Control  -  Version  2 

TLK  utility 

File  Access  Listener    -  FAL,7).AP.  Version  4 

Host  Task  Loader 

Network  Intormation  and  Control  E.xchange 

RST.'^  K  media  transfer  program 

Reser\ed  for  DFlCnet  use 

Network  terminal  handler 

Reserved  for  DPX'net  use 

Network  management  loopback  mirror 

.Network  management  event  receiver 

Reserved  for  DPX'net  use 

Heterogeneous  termina'  host 

Reserved  ff)r  DKCnet  use 

R."^X  DKCnet  test  too! 

Reserved  for  DKCnet  use 

Reserved  for  customer  extensions 
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Appendix  C 

Network  Management  Event  Logger  Interface 


The  logging  monitor  interface  from  the  DECnet  event-logging  facility  provides 
a  mechanism  by  which  a  user-vritten  program  can  process  network  events. 
You  must  specify  the  name  of  the  monitoring  program  and  the  events  to  be 
logged  by  using  the  \CP  SET  LOGGING  command,  as  follows: 

\CP>SET  LOGGING  MONITOR  NAME  name  STATE  ON 
NCP>SET  LOGGING  MONITOR  EVENTS  event-list 


where 
name 

event -list 


is  the  name  of  the  program  to  receive  the  event  information 
(default:  MON...). 

identifies  one  or  more  event  classes  and  types  to  be  logged.  See 
Chapter  2  for  the  event  list  format  and  see  Appendix  D  for  a  list 
of  event  classes  and  types. 

NOTE 

The  event  monitor  facility  can  be  used  in  con- 
junction with  event  logging  on  the  console  or  to  a 
file. 

If  the  monitor  is  inactive,  it  is  invoked  when  the  first  event  is 
about  to  be  processed.  Your  program  should  open  the  network 
(OPNS)  and  use  the  GND$  directive  to  retrieve  the  event  infor- 
mation from  the  mailbox.  The  mailbox  is  a  message  buffer  that 
receives  the  event  information.  When  events  occur,  the  I/O 
status  block  for  the  GNDS  call  contains  the  following  on  return 
from  the  call: 

Word  0:         Byte  0  =  IS.SUC/IE.DAO 
Byte  1  =  NT.EVT(6) 

Word  1:         Number  of  bytes  of  event  information 
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The  mailbox  returned  by  GND$  contains  the  event  information 
in  the  following  format: 

Word  0,1:  is  the  source  program  name  in  Radix-50.  The 
source  program  is  the  program  that  sent  the  event 
information.  EVC...  is  the  name  of  the  program 
used  for  locally  generated  events;  EVR...  is  the 
name  of  the  program  used  for  remotely  generated 
events. 

Word  2-n:  is  the  event  information  given  as  a  NICE  protocol 
message.  The  format  of  the  information  can  be 
found  in  the  DNA  Network  Management  Func- 
tional Specification. 

After  processing  the  event  data,  the  program  can  keep  the  mail- 
box open  and  wait  for  further  events,  or  it  can  exit  and  be  rein- 
voked  when  the  next  event  occurs. 
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Appendix  D 

Event  Class  and  Type  Summary 


Events  are  summarized  by  class  and  type  in  this  appendix.  In  general,  event 
classes  relate  to  specific  layers  of  the  DECnet  architecture.  Event  types  relate 
to  specific  events  within  an  event  class. 

NOTE 

Asterisks  are  used  throughout  this  appendix  to  flag  events  and 
event  classes  that  are  not  logged  by  DECnet-RSX. 


D.1    Event  Classes 


Event  logging  supports  the  event  classes  listed  in  Table  D-1.  DECnet-RSX 
does  not  log  events  for  classes  marked  with  an  asterisk.  However,  processed 
events  in  these  classes  from  other  remote  nodes  are  logged. 

Table  D-1:    Event  Classes 


• 


Event  Class 

0 

1  * 
2 
3 

4 
5 
6* 

7-31  * 

.32-63  * 

64-95 

96-127  * 
128-159  * 
160-479  * 


Description 

Network  Management  layer 

Application  layer 

Session  Control  layer 

End  Communications  layer 

Transport  layer 

Data  Link  layer 

Physical  Link  layer 

Reserved  for  other  common  classes 

Reserved  for  RSTS  systems 

RSX  system  specific 

Reserved  for  TOPS-20  systems 

Reserved  for  VM.S  systems 

Reserved  for  future  use 


D-1 


D.2    Event  Message  Format 

Event  messages  have  the  following  format: 

Event  type  class,  type  [event-text] 

Occurred  dd-mon-yy  hh.mm.ss  on  node  address  [(node-name)] 
[entity-type  [entity-name]] 
[data] 


where 

class 

type 

event-text 

address 

node-name 

dd-mon-yy 

hh:mm:ss 

entity -type 

entity-name 

data 


is  the  layer  in  which  the  event  occurred. 

is  the  specific  type  of  event  for  that  class. 

is  the  text  describing  the  event  (does  not  print  for  RSX-llS). 

is  the  address  of  the  node  at  which  the  event  occurred. 

is  the  name  of  the  node  at  which  the  event  occurred. 

is  the  date  (day,  month,  and  year)  on  which  the  event  oc- 
curred. 

is  the  time  (hour,  minutes,  and  seconds)  at  which  the  event 
occurred. 

is  one  of  four  types:  line,  circuit,  node,  or  module. 

is  the  name  of  the  entity  that  caused  the  event. 

is  event-dependent  text  that  gives  more  information  about  the 
event.  Often  this  text  includes  the  component  type  and  name 
for  which  the  event  applies.  It  may  also  provide  additional 
information  about  the  cause  of  the  event. 


Example: 


Euent  type  0.3 t  Automatic  service 
Occurred  21-0CT-83  08:17:11  on  node  19  (PITSBG) 
Circuit  U  N  A  -  0 
S  e  r  I.'  1  c  e  t  y  p  e  =  L  0  a  d 
Status  =  Operation  failure 

The  following  sections  list  event  messages  by  class  and  type  for  each  layer. 
Individual  events  and  entire  event  classes  that  are  marked  with  an  asterisk 
are  not  logged  by  DECnet-RSX  components. 

Event  messages  shown  in  this  appendix  have  the  following  format: 


O.OiEvent  records  losti 


Event  class 


t 

Event  message  text 


Event  type 
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D.3    Network  Management  Layer  Events 

0.0    Event  records  lost 

Events  occurred  too  rapidly  for  the  event  logjjer  to  butler  them. 
This  message  does  not  display  any  event  qualitlers. 
0.1    Automatic  node  counters  * 
A  node  counter  timer  expired. 

This  message  displays  the  address  and  name  of  the  node  to  which  the 
event  applies  and  the  counters  for  that  node. 

0.2    Automatic  line  counters 

A  line  counter  timer  expired. 

This  message  displays  the  name  of  the  line  to  which  the  event  applies  and 
the  counters  for  that  line. 

0.3    Automatic  service 

An  adjacent  node  requested  an  automatic  circuit  service  operation. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies, 
as  well  as  two  event  qualifiers:  the  service  function  performed  (load  or 
dump)  and  the  status  of  the  operation  (requested,  successful,  ()r  failed).  If 
the  operation  fails,  this  status  includes  an  error  message  from  line  watcher 
(LIN$$$)  and  details. 

0.4    Line  counters  zeroed  * 

Line  counters  were  zeroed. 

This  message  displays  the  name  of  the  line  to  which  the  event  applies.  The 
event  logger  records  these  counters  prior  to  the  execution  of  a  request  to 
zero  them. 

0.5    Node  counters  zeroed  * 

Node  counters  were  zeroed. 

This  message  displays  the  address  and  name  of  the  node  to  which  the 
event  applies.  The  message  can  also  include  the  node  counters  that  were 
affected.  The  event  logger  records  these  counters  prior  to  the  execution  of 
a  request  to  zero  them. 

0.6    Passive  loopbacl( 

The  software  initiated  or  terminated  a  passive  loopback  test  on  behalf  of 
an  adjacent  node. 

This  message  displays  the  circuit  name  to  which  the  event  applies  and  the 
state  of  operation  qualifier  (initiated  or  terminated). 
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0.7    Aborted  service  request 

An  adjacent  node  requested  a  senice  over  a  circuit  connected  to  the  local 
node.  However,  a  problem  prevented  it  from  bein^  processed  locally. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies 
and  the  reason  for  failure.  Possible  reasons  are: 

Circuit  open  error 

LIN$$$  received  a  MOP  message  and  was  unable  to  acquire  control  of 
the  circuit.  Possible  causes  are:  LI\$$.S  did  not  have  the  privilege  to 
perform  the  operation,  or  it  could  not  set  the  sub.state  of  the  circuit,  or 
the  circuit  had  another  owner. 

Circuit  state  change  by  higher  ievel 

The  circuit  was  preempted  by  a  higher  priority  function.  For  example, 
you  u.sed  XCP  to  turn  the  line  off. 

Receive  error 

A  line  error  occurred  while  trying  to  receive  the  request. 
Receive  timeout 

The  line  message  receive  timer  expired  before  the  request  could  be 
received  from  the  adjacent  node.  Possible  causes  are:  the  timer  was  too 
short,  the  line  error  level  was  too  great  for  any  message  to  get  through, 
or  the  adjacent  node  stopped  requesting. 

Unrecognized  request 

A  message  was  received  but  was  not  recognizable  as  a  request  for  up- 
line dumping,  down-line  loading,  or  passive  loopback  testing.  The  ad- 
jacent node  may  be  running  an  incompatible  version  of  the  line  service 
protocol. 

0.8    Automatic  counters  * 

A  counter  timer  for  something  other  than  a  node  or  line  expired  (for 
example,  a  DTE  counter  timer). 

0.9    Counters  zeroed  * 

Counters  for  something  other  than  a  node  or  line  were  zeroed  (for  example, 
a  DTE  counter  timer). 
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D.4    Session  Control  Layer  Events 

2.0  Local  node  state  change 

The  operational  state  of  the  local  node  changed  due  to  an  operator  com- 
mand. Note  that  the  transition  from  SHl'T  to  OFF  also  happens  automat- 
ically when  the  last  logical  link  is  disconnected  (under  normal  operation). 

This  message  displays  the  reason  for  the  state  change  (operator  command 
or  normal  operation),  the  old  state  (ON.  OFF.  SHIT,  or  RKSTRICTED), 
and  the  new  state  (ON.  OFF.  SHIT,  or  RESTRKTED). 

2.1  Access  control  failure 

The  local  node  rejected  a  connection  request  due  to  invalid  access  control 
information. 

This  message  displays  the  name  and  address  of  the  source  node,  the  object 
type  number  and  process  ID  of  the  s(<urce  process  requesting  the  connec- 
tion, the  object  type  number  and  process  ID  of  the  destination  process  to 
receive  the  connection  request,  and  the  invalid  access  control  information 
(user  ID.  password,  and  account  information). 

D.5    End  Communications  Layer  Events 

3.0  Invalid  message  * 

KCL  received  a  message  that  could  not  be  interpreted.  This  may  indicate 
a  software  maltunction  in  either  the  local  or  the  remote  FX'L. 

This  message  displays  the  invalid  KCL  me.ssage.  See  the  I)\A  Xrtuorh 
Scnirrs  Protocol  Functional  Specification  for  a  description  of  VA^L  mes- 
sages. 

3.1  Invalid  flow  control  * 

The  remote  ECL  attempted  to  invalidly  modify  the  local  How  control 
value.  This  may  indicate  a  software  malfunction  in  either  the  local  or  the 
remote  ECL. 

This  message  displays  the  invalid  ECL  message  and  the  current  flow 
control  value.  See  the  l)\A  \ctirorh  Scnicvs  Protocol  Functional  Specifi- 
cation for  a  description  of  How  control. 

3.2  Node  data  base  reused 

The  local  node  received  a  connection  request  from  or  tried  to  initiate  an 
outgoing  crmnect  to  a  node  for  which  there  is  no  counter  block.  All  counter 
blocks  have  been  previously  used,  and  one  of  the  previously  used  blocks  is 
available  for  this  new  node.  This  results  in  the  loss  of  node  counters  for  the 
node  that  formerly  occupied  the  data  base  entry. 

This  message  displays  the  address  and  name  of  the  node  for  which  the 
data  base  entrv  was  formerlv  used  and  the  counters  for  that  node. 
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D.6   Transport  Layer  Events 


4.0    Aged  packet  loss 


A  packet  has  been  discarded  because  it  has  visited  too  many  nodes.  This 
can  be  a  normal  occurrence  when  the  network  is  reconfiguring  its  routing 
data  bases,  or  it  can  be  a  failure  when  the  value  specified  for  maximum 
hops  is  too  small.  This  can  cause  the  value  specified  for  maximum  visits  to 
be  too  small  for  a  path  that  should  be  usable. 

This  message  displays  the  packet  header  only.  This  is  information  from 
the  beginning  of  the  packet.  It  consists  of  a  hexadecimal  byte  of  flags,  the 
decimal  destination  and  source  node  addresses,  and  a  hexadecimal  byte  of 
forwarding  data.  See  the  DNA  Routing  Layer  Functional  Specification  for 
additional  information. 

4.1  Node  unreachable  packet  loss 

A  packet  has  been  discarded  because  the  local  node  found  that  the  desti- 
nation node  was  unreachable.  This  event  provides  a  trace  of  what  has 
happened  to  packets  that  are  not  reaching  their  destinations. 

This  message  displays  the  packet  header  and  the  name  of  the  circuit  to 
which  the  event  applies.  The  packet  header  is  described  in  event  4.0. 

4.2  Node  out  of  range  packet  loss 

A  packet  has  been  discarded  because  the  destination  node  number  was 
greater  than  the  maximum  node  number  known  to  the  local  node.  Nor- 
mally, this  results  from  the  addition  of  a  new  node  to  the  network  without 
increasing  the  value  specified  for  maximum  address  on  the  local  node  and 
still  expecting  the  local  node  to  route  packets  to  the  new  node. 

This  message  displays  the  packet  header  and  the  name  of  the  circuit  to 
which  the  event  applies.  The  packet  header  is  described  in  event  4.0. 

4.3  Oversized  packet  loss 

A  packet  has  been  discarded  because  it  was  too  large  to  forward  to  the 
appropriate  adjacent  node.  Normally,  this  condition  occurs  because  the 
adjacent  node's  buffer  is  too  small  or  the  source  node  sent  a  packet  that 
was  too  large.  The  latter  condition  can  be  handled  by  setting  a  smaller 
segment  size  at  the  source  node. 

This  message  displays  the  packet  header  and  the  name  of  the  circuit  over 
which  the  packet  was  to  be  forwarded.  The  packet  header  is  described  in 
event  4.0. 
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4.4  Packet  format  error 

A  packet  has  been  discarded  due  to  a  format  error  in  the  packet  header. 
Usually,  this  results  from  a  programming  error  in  packet  formatting  by  the 
adjacent  node.  It  could  also  result  from  a  circuit  error  not  detected  by 
circuit  protocol. 

This  message  displays  a  packet  header  and  the  name  of  the  circuit  to 
which  the  event  applies.  This  consists  of  the  first  6  bytes  of  the  packet 
displayed  in  hexadecimal. 

4.5  Partial  routing  update  loss 

A  routing  message  containing  node  addresses  greater  than  the  maximum 
address  known  to  the  local  node  has  been  received.  Subsequently,  infor- 
mation on  these  nodes  was  lost.  This  occurs  when  the  value  specified  for 
the  maximum  address  on  an  adjacent  node  is  increased  but  the  same 
value  for  the  local  node  is  not  increased. 

This  message  displays  the  name  of  the  circuit  over  which  this  message  was 
received,  the  packet  header  (see  event  4.0),  and  the  highest  node  address 
in  the  routing  update  that  was  lost. 

4.6  Verification  reject 

Initialization  with  an  adjacent  node  has  failed.  The  local  node  received  an 
invalid  password.  The  receive  password  does  not  match  the  remote  node's 
transmit  password.  You  must  either  change  one  of  the  passwords  or  clear 
the  receive  password. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies 
and  the  address  and  name  of  the  adjacent  node  that  failed  to  initialize. 

4.7  Circuit  down  —  circuit  fault 

Line  and/or  device  hardware  failure. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies 
and  the  reason  for  the  event.  Possible  reasons  are: 

Adjacent  node  address  change 

The  adjacent  node  changed  addresses  without  going  through  the  nor- 
mal initialization  sequence.  This  is  logged  when  an  adjacent  node 
attempts  to  initialize  with  the  local  node  but  the  adjacent  node's  ad- 
dress is  not  in  the  data  base. 
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Adjacent  node  address  out  of  range 

The  adjacent  node's  address  is  ^eater  than  the  maximum  address 
defined  for  the  local  node.  This  can  be  caused  by  ail  incorrectly  de- 
fined node  address  or  by  a  failure  to  increase  the  maxim>.«n  node 
address  in  the  local  node's  data  base  when  a  new  node  was  added. 

Adjacent  node  block  size  too  small 

The  line  block  size  provided  by  the  adjacent  node  is  too  small  for 
normal  network  operation.  The  block  size  may  be  set  incorrectly  at  the 
adjacent  node. 

Adjacent  node  listener  receive  timeout 

The  node  has  received  no  message  over  the  data  link  within  the  last  30 
seconds.  Most  likely  the  remote  node  is  not  running. 

Adjacent  node  listener  received  invalid  data 

A  test  message  sent  by  the  adjacent  noae  contained  invalid  or  cor- 
rupted data.  This  is  most  likely  caused  by  a  hardware  problem. 

Circuit  synchronization  lost 

The  normal  circuit  protocol  was  restarted  or  terminated  by  the  adja- 
cent node.  Either  a  circuit  exceeded  an  error  threshold  or  network 
management  initiated  a  circuit  state  change. 

Data  errors 

The  circuit  was  declared  down  by  the  local  node's  circuit  protocol 
handler  when  the  circuit  exceeded  an  error  threshold. 

Invalid  verification  seed  value 

A  transport  initialization  message  sent  by  an  adjacent  node  is  improp- 
erly formatted.  This  is  most  likely  caused  by  a  remote  network  soft- 
ware problem. 

Routing  update  checitsum  error 

A  routing  update  packet  failed  its  internal  integrity  test 

Unexpected  packet  type 

A  packet  was  received  out  of  the  normal  protocol  sequence.  For  exam- 
ple, the  local  node  received  a  normal  data  packet  when  it  expected  a 
verification  packet. 

Verification  receive  timeout 

A  required  verification  packet  was  not  received  from  the  a  ■^.'  ;cent  node 
within  the  required  response  time.  Either  packets  were  lost  on  the 
circuit  or  a  failure  occurred  at  the  adjacent  node. 
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Version  skew 

The  routing  version  of  the  adjacent  node  is  unacceptable  to  the  local 
node.  The  operator  may  have  installed  incorrect  software  at  the  adja- 
cenf  node. 

4.8  Circuit  down 

A  software  error  occurred  on  the  circuit  and  the  circuit  has  been  taken  out 
of  service.  Common  causes  of  this  event  include  the  following: 

•  There  is  a  hardware  problem  with  the  line  and/or  a  device. 

•  The  remote  circuit  has  recycled.  This  could  result  from  an  incorrect 
password  sent  from  this  node  during  initialization. 

•  The  operator  turned  the  remote  circuit  off  and  on. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies, 
the  packet  header  (see  description  under  event  4.0),  and  the  reason  for  the 
event  (see  the  reasons  listed  for  event  4.7). 

4.9  Circuit  down  -  operator  initiated 

An  operator  has  turned  the  circuit  off. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies, 
the  packet  header  (see  description  under  event  4.0),  the  expected  node 
address  and  name,  and  the  reason  for  tne  event  (see  the  reasons  listed  for 
event  4.7). 

4.10  Circuit  up 

A  remote  node  has  been  initialized  on  one  of  the  circuits  connected  to  the 
local  node. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies, 
as  well  as  the  name  and  address  of  the  newly  initialized  (adjacent)  node. 

NOTE 

On  a  routing  node,  this  event  does  not  imply  that  the  node  is 
reachable.  Reachability  is  determined  by  the  higher  level  rout- 
ing algorithms.  For  the  UNA  and  QNA,  the  event  signifies  that 
all  basic  initialization  has  been  completed  by  the  device  and 
transceiver. 

4.11  initialization  failure  ~  iine  fauit 

A  remote  node  failed  to  initialize  with  the  local  node  due  to  a  line  error. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies 
and  the  reason  for  the  event  (see  the  reasons  listed  for  event  4.7). 
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4.12  Initialization  failure  —  software  fault 

A  remote  node  failed  to  initialize  with  the  local  node  due  to  a  software 
error. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies, 
the  packet  header  (see  description  under  event  4.0), and  the  reason  for  the 
event  {see  the  reasons  listed  for  event  4.7). 

4.13  Initialization  failure  —  operator  fault 

A  remote  node  failed  to  initialize  with  the  local  node  due  to  an  operator 
error. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies, 
the  packet  header  (see  description  under  event  4.0),  the  reason  for  the 
event  (see  the  reasons  listed  for  event  4.7),  and  the  version  received  from 
the  adjacent  node. 

4.14  Node  reachability  change  * 

There  has  been  a  change  in  the  reachability  of  a  particular  node. 
This  message  displays  the  new  node  status. 

4.15  Adjacency  up 

For  broadcast  circuits  (UNA  and  QXA),  initialization  has  occurred  with 
another  node  on  the  Ethernet.  End  nodes  log  this  message  for  only  one 
node. 

This  message  displays  th(,'  adjacent  node  number. 

4.16  Adjacency  rejected 

For  broadcast  circuits  (UNA  and  QNA),  initialization  has  been  rejected. 
The  number  of  broadcast  end  nodes  may  have  been  exceeded. 

The  message  displays  the  reason  for  the  rejection. 

4.18  Adjacency  down 

The  remote  node  has  recycled.  This  event  could  result  from  a  remote  node 
restart  or  an  invalid  protocol  message. 

The  message  displays  the  reason  why  the  adjacent  node  is  down. 

4.19  Adjacency  down  —  operator  initiated  * 

The  operator  has  turned  the  Ethernet  circuit  off.  For  DECnet-RSX,  this 
event  is  logged  as  event  4.9  (see  above). 
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D.7    Data  Link  Layer  Events 

5.0  Locally  Initiated  state  change  * 

An  ()j)erator  coinniand  chan^'ed  the  circuit  state. 

This  message  displays  the  name  of  the  circuit  to  which  the  even  applies, 
the  old  DDCMP  state  iHALTKI).  ISTHT.  ASTHT.  HrNNlNd.  or 
MAINTP:NAN('E).  and  the  new  DDCMP  state  (see  the  old  DDCMP 
states).  See  the  DSA  DDCMl'  Functional  Spt'cificadon  tor  a  descrifition 
ot  these  states. 

5.1  Remotely  initiated  state  change  * 

A  remote  user  changed  the  circuit  state. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies 
and  the  old  and  new  DDCMP  state  (see  event  5.0  tor  the  states). 

5.2  Protocol  restart  received  In  maintenance  mode  * 

The  remote  node  restarted  normal  operation  while  the  local  node  had  the 
circuit  in  maintenance  mode. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  aj)plies. 

5.3  Send  error  threshold  * 

Too  many  data  transmission  errors  occurred. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies. 

5.4  Receive  error  threshold  * 

Too  many  data  reception  errors  occurred. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies. 

5.5  Select  error  threshold  * 

Too  many  .selection  errors  occurred. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies. 

5.6  Block  header  format  error  * 
DDCMP  received  an  invalid  block  header. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies. 

5.7  Selection  address  error  * 

The  wrong  tributary  responded  to  the  polling  process.  Only  multipoint 
control  stations  experience  this  event.  This  event  occurs  when  one  of  these 
stations  receives  a  message  that  does  not  match  the  address  of  the  cur- 
rently selected  tributary. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies. 
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5.8  Streaming  tributary  * 

A  tributary  on  the  circuit  is  impeding  the  use  of  that  circuit. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies. 

5.9  Locai  buffer  too  smaii  * 

A  local  buffer  is  too  small  to  receive  a  block  of  data. 

This  message  displays  the  name  of  the  circuit  to  which  the  event  applies. 

5.10  Restart  * 

The  DTE  completed  a  restart  procedure.  That  is.  X.25  level  3  either  has 
sent  a  restart  confirm  signal  to  a  received  restart  command  or  has  received 
a  restart  confirm  signal  to  a  transmitted  re?.tart  command. 

This  message  displays  the  module  name,  the  DTE  name,  the  cause,  and  a 
diagnostic. 

5.11  State  change  * 

The  operational  state  of  a  module  was  changed  by  the  operator  commanJ. 

This  message  displays  the  name  of  the  module  whose  state  wa.>  changed, 
the  name  of  the  DTE  where  the  module  resides,  the  reason  for  the  change, 
the  old  state,  and  the  new  i  .ate. 

5.12  Retransmit  maximum  exceeded  * 

The  retry  count  for  the  restart  retransmission  expired. 

This  message  displa\s  the  name  of  the  module  \  hose  retransmit  maxi- 
mum was  exceeded,  the  name  of  the  DTP'  where  he  module  resides,  and 
the  parameter  for  which  the  maximum  was  set. 

5.13  Initiaiization  faiiure 

The  line  could  not  be  initialized  because  of  a  device  error. 

This  message  displays  the  name  of  the  device  that  could  not  be  enabled. 
Depending  upon  the  implementation,  a  reason  for  the  failure  might  also 
be  reported. 

5.14  Send  faiied 

An  error  occurred  during  a  transmit  operation. 

This  message  displays  the  name  oi  the  line  over  which  the  transmit  opera- 
tion was  attempted  and  the  reason  for  failure,  ^^ossible  reasons  are: 

Carrier  checi(  failed 
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The  data  link  diJ  ,•.- 

transmit  mfssage.  There  is  a  failure  in  either  the  transmitting  or  the 

receiving  hardware  (possibly  with  the  transceiver  or  its  cable). 


• 
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Excessive  collisions 

The  maximum  number  of  retransmissions  due  to  collisions  has  been 
exceeded.  This  is  caused  when  too  many  systems  on  the  Ethernet  are 
trying  to  transmit  at  once. 

Frame  lOO  long  * 

The  transmit  message  was  truncated.  Either  the  local  node  tried  to 
send  a  message  that  exceeded  the  maximum  allowable  size  or  an  error 
in  the  local  hardware  cut  off  transmission  before  the  actual  maximum 
size  was  reached. 

Open  circuit 

There  is  a  break  in  the  Ethernet  coaxial  cable.  The  event  message  will 
include  an  estimated  distance  to  the  failure  (in  bit  times).  If  other 
systems  are  reporting  the  same  problem,  the  failure  is  on  the  network 
cable  rather  than  with  local  hardware. 

Remote  failure  to  defer 

A  remote  system  began  transmitting  after  the  allowable  time  for  colli- 
sions had  elapsed.  This  could  indicate  a  weak  transmitter  on  the  local 
node  or  a  problem  with  the  remote  carrier  sense  circuitry. 

Short  circuit 

Either  there  is  a  short  circuit  in  the  Ethernet  coaxial  cable,  or  the 
transceiver  or  transceiver/controller  cable  failed.  The  event  message 
will  include  an  estimated  distance  to  the  failure  (in  bit  times).  If  other 
systems  are  reporting  the  same  problem,  the  failure  is  on  the  network 
rather  than  with  local  hardware. 

5.15    Receive  failed 

An  error  occurred  during  a  receive  operation. 

This  message  displays  the  name  of  the  line  over  which  the  receive  opera- 
tion was  attempted  and  the  reason  for  failure.  Possible  reasons  are: 

Block  check  error 

The  message  failed  the  cyclic  redundancy  check  (CRC).  Possible 
causes  are  electromagnetic  interference,  late  collisions,  or  improperly 
set  hardware  parameters  (such  as  receiver  squelch). 

Data  overrun 

The  message  was  lost  due  to  a  hardware  failure  such  as  insufficient 
hardware  buffers  or  insufficient  CPU  time. 

Frame  too  long 

The  message  was  discarded  because  a  remote  system  .lent  a  message 
that  exceeded  the  maximum  allowable  length. 
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Framing  error 

The  message  did  not  contain  a  multiple  of  8-bit  bytes.  Possible  causes 
are  electromagnetic  interference,  late  collisions,  or  improperly  set 
hardware  parameters  (such  as  receiver  squelch). 

System  buffer  unavailable 

The  message  was  discarded  because  there  was  no  system  buffer  avail- 
able to  receive  it.  There  are  not  enough  system  buffers  on  the  local 
system. 

Unrecognized  frame  destination  * 

The  message  waj  discarded  because  there  was  no  active  user  with  the 
specified  protocol  type  or  address  enabled.  Either  the  local  system  has 
not  enabled  a  protocol  or  an  address  that  it  should  have,  or  a  remote 
system  is  trying  to  use  a  protocol  that  is  locally  unsupported. 

User  buffer  unavailable  * 

The  message  was  discarded  because  there  was  no  user  buffer  available 
to  receive  it.  The  user  has  not  supplied  enough  buffers  in  the  user 
process. 


D.8    Physical  Link  Layer  Events  * 

6.0  Data  set  ready  transition 

A  t:  ansition  in  the  dataset  ready  signal  was  detected  by  the  interface 
hardware. 

The  message  displays  the  name  of  the  line  on  which  the  transition  oc- 
curred. 

6.1  Ring  indicator  transition 

A  transition  in  the  ring  indicator  signal  was  detected  by  the  interface 
hardware. 

This  message  displays  the  name  of  the  line  on  which  the  transition  oc- 
curred. 

6.2  Unexpected  carrier  transition 

A  transition  in  the  carrier  signal  was  detected  by  the  interface  hardware. 

This  message  displays  the  name  of  the  line  on  which  the  transition  oc- 
curred. 

6.3  IVIemory  access  error 

The  interface  hardware  tried  to  access  nonexistent  memory. 

This  message  displays  the  name  of  the  line  on  which  the  error  occurred. 
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6.4  Communications  interface  error 

The  interface  hardware  detected  an  error  in  itself. 

This  message  displays  the  name  of  the  line  on  which  the  error  occurred. 

6.5  Performance  error 

A  soft  error  has  been  detected.  This  error  may  degrade  performance. 

This  message  displays  the  name  of  the  line  on  which  the  error  was  de- 
tected. 


D.9    RSX  System-specific  Events 

64.1  Routing  data  base  corrupt 

The  routing  algorithm  detected  an  inconsistency  in  the  routing  data  bases. 
The  algorithm  will  not  send  routing  messages. 

This  message  displays  the  event  text  only. 

64.2  Routing  data  base  restored 

The  routing  data  base  has  been  restored  by  the  receipt  of  valid  routing 
messages  from  other  nodes.  The  routing  algorithm  will  start  .sending  rout- 
ing messages  again. 

This  message  displays  the  event  text  only. 
68.14    Normai  usage  terminated 

The  operator  turned  off  the  circuit. 

This  message  displays  the  name  of  the  circuit  that  was  shut  down. 
94.0    DCE  detected  packet  error 

The  DCE  detected  an  X.25  level  3  error  on  a  circuit. 

This  message  displays  the  name  of  the  DTE  associated  with  that  circuit, 
the  diagnostic  code  received  from  the  network,  and  the  first  6  bytes  of  the 
diagnostic  packet. 

96.0    State  change 

This  message  displays  the  reason  for  the  X.25  server  module  state  change, 
the  old  state,  and  the  new  state. 
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Appendix  E 

Network  Counter  Summary 


The  network  software  maintains  counters  for  lines,  circuits,  certain  modules, 
nodes,  and  the  system.  In  some  cases,  the  counters  respond  to  and  reflect 
network  events.  (Events  are  defined  in  the  discussion  of  event  logging  in 
Chapter  2.)  In  other  cases,  the  counters  respond  to  and  reflect  normal  activi- 
ties such  as  messages  sent  and  messages  received.  Individual  counter  descrip- 
tions indicate  whether  that  counter  is  incremented  when  a  corresponding 
event  occurs  (see  Appendix  D  for  a  description  of  event  messages).  Where 
possible,  the  reasons  why  each  of  the  counters  might  be  incremented  are 
included  in  the  description. 

In  this  appendix,  counters  are  presented  in  alphabetical  order  within  compo- 
nent groups.  If  you  receive  a  counter  number  instead  of  the  usual  text  when 
executing  commands  remotely  at  an  RSX  node  from  a  non-RSX  node,  refer  to 
the  lists  that  correlate  counter  type  numbers  with  counter  text  in  Appendix  F. 
Then  look  up  the  counter  description  in  this  appendix  for  full  details. 

A  counter  does  not  display  a  value  greater  than  its  maximum  value.  When  a 
counter  overflows,  it  locks  on  the  overflow  value  until  it  is  zeroed  (see  the 
ZERO  commands  in  Chapter  6).  Counter  displays  with  an  angle  bracket  (:>) 
indicate  that  the  counter  has  overflowed.  For  example,  if  the  maximum  value 
for  a  counter  is  254,  its  overflow  display  is  >254.  Each  of  the  counter  descrip- 
tions in  this  appendix  includes  the  maximum  value  of  the  counter. 

Each  category  of  counters  maintains  a  timing  counter  (seconds  since  last 
zeroed)  that  is  zeroed  when  its  associated  counters  are  zeroed  and  starts  when 
they  start.  In  this  way,  the  timing  counter  logs  the  seconds  since  its  associated 
counters  were  zeroed  to  provide  a  time  frame  for  them.  For  example,  if  you 
examined  the  system  counters  and  found  that  the  control  buffer  allocation 
failed  counter  registered  700,  you  can  determine  the  frequency  of  the  failures 
by  also  checking  the  associated  seconds  since  last  zeroed  counter. 

The  counter  descriptions  in  this  appendix  explain  some  uses  of  the  counters, 
but  they  should  not  be  considered  an  exhaustive  trouble-shooting  guide.  For 
detailed  information  on  counters  or  the  software  design  and  algorithms  they 
represent,  consult  the  various  architectural  specifications. 
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E.1    Circuit  Counters 


There  are  five  groups  of  circuit  counters.  There  are  three  in  the  Data  Link 
layer,  and  one  each  in  the  Network  Management  and  Transport  layers.  The 
Data  Link  groups  cover  DDCMP,  Ethernet,  and  X.25  permanent  virtual  cir- 
cuits (PVCs). 


• 


E.1.1    Network  Management  Layer:  All  Circuits 

Seconds  since  last  zeroed 

This  counter  starts  when  the  other  circuit  counters  are  zeroed,  h  increments 
by  2  every  2  seconds.  This  counter  is  zeroed  when  the  other  circuit  counters 
are  zeroed,  so  as  to  provide  a  time  frame  for  them.  The  overflow  value  is 
65,534. 


E.I. 2   Transport  Layer:  All  Circuits 

Circuit  down 

This  counter  records  the  number  of  times  that  a  circuit  was  declared  down  by 
the  executor.  The  overflow  value  is  254. 

Corruption  loss 

This  counter  records  the  number  of  times  that  a  checksum  failure  occurred  on 
a  PSN.  The  overflow  value  is  254. 

initialization  failure 

This  counter  increments  when  the  circuit  could  not  be  initialized  by  the 
executor  for  network  use.  The  overflow  value  is  254. 

Originating  pacl(ets  ^ent 

This  counter  records  the  number  of  packets  sent  by  ne  executor  over  the 
circuit.  The  overflow  value  is  4,2r4,967,294. 

Terminating  packets  received 

This  counter  records  the  number  of  packets  received  by  the  executor  with  the 
executor  as  the  destination.  The  overflow  value  is  4,294,967,294. 

Transit  congestion  loss 

This  counter  records  the  number  of  packets  received  by  the  executor  that  were 
to  be  routed  to  another  node  but  were  discarded  because  of  heavy  traffic  on 
the  output  circuit.  The  overflow  value  is  65,534.  This  counter  is  kept  for 
routing  nodes  only. 

Transit  packets  received 

This  counter  increments  when  the  executor  receives  a  packet  that  is  to  be 
routed  to  another  node.  The  overflow  value  is  4,294,967.294.  This  counter  is 
kept  for  routing  nodes  only. 
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Transit  packets  sent 

This  counter  increments  when  the  executor  sends  a  packet  through  to  another 
node.  The  overflow  value  is  4,294,967,294.  This  counter  is  kept  for  routing 
nodes  onlv. 


• 


E.1.3    Data  Link  Layer:  DDCMP  Circuits 

Bytes  received 

This  counter  increments  when  a  data  byte  is  received  on  the  circuit.  The 
count  does  not  include  Data  Link  Protocol  overhead  or  bytes  retransmitted  by 
the  Data  Link  layer.  It  can  be  used  with  the  counter  or  data  blocks  received  to 
determine  the  inbound  traffic  load  on  the  circuit.  The  overflow  value  is 
4.294.9G7  294. 

Bytes  sent 

This  counter  increments  when  a  data  byte  is  sent  on  the  circuit.  The  count 
does  not  include  Data  Link  Protocol  overhead  or  bytfs  retransmitted  by  the 
Data  Link  layer.  It  can  be  used  with  the  counter  or  data  blocks  received  to 
determine  the  outbound  traffic  load  on  the  circuit.  The  overflow  value  is 
4.294.967.294. 

Data  biocks  received 

This  cou»-ter  increments  when  a  data  block  is  received  on  the  circuit.  The 
count  does  not  include  Data  Link  Protocol  overhead.  This  counter  can  be  used 
as  a  statistical  base  for  evaluating  the  other  Data  Link  layer  counters.  The 
overflow  value  is  4.294,967.294. 

Data  biocks  sent 

This  counter  increments  when  a  data  block  is  sent  on  the  circuit.  The  count 
does  not  include  Data  Link  Protocol  overhead  or  blocks  retransmitted  by  the 
Data  Link  layer.  It  can  be  used  as  a  statistical  base  for  evaluating  the  other 
Data  Link  layer  counters.  The  overflow  value  is  4,294,967,294. 

Data  errors  inbound 

This  counter  indicates  the  number  of  incoming  data  errors  on  the  circuit.  It 
can  have  any  of  the  following  qualifiers:  NAKs  sent,  data  field  block  check 
error;  NAKs  sent,  reply  response.  The  overflow  value  is  254. 

Data  errors  outbound 

This  counter  indicates  the  number  of  outgoing  data  errors  on  the  circuit.  It 
can  have  any  of  the  following  qualifiers:  NAKs  received,  header  block  check 
error;  NAKs  received,  data  field  block  check  error;  NAKs  received,  reply 
response.  The  overflow  value  is  254. 

Locai  buffer  errors 

This  counter  increments  when  a  negative  acknowledge  (NAK)  is  sent.  It  can 
have  any  of  the  following  qualifiers:  NAKs  sent,  buffer  unavailable;  NAKs 
stnt,  buffer  too  small.  The  overflow  value  is  254. 
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Local  reply  timeouts 

This  counter  increments  each  time  that  a  message  is  retransmitted  because 
the  retry  timer  for  a  sent  message  expired  before  an  ACK  was  received  from 
the  remote  node.  The  overflow  value  is  254. 

Remote  buffer  errors 

This  c-  'Huer  increments  when  a  negative  acknowledge  (NAK)  is  received.  It 
can  h  /e  any  of  the  following  qualiflers:  NAKs  received,  buffer  unavailable: 
NAKs  received,  buffer  too  small.  The  overflow  value  is  254. 

Remote  reply  timeouts 

This  counter  increments  each  time  that  a  message  is  retransmitted  because 
the  retry  timer  for  a  sent  message  expired  before  an  ACK  from  your  node  was 
received  at  the  remote  node.  The  overflow  value  is  254. 

Selection  intervals  elapsed 

This  counter  records  the  number  of  times  that  the  executor  turned  a  circuit 
around  or  selected  an  adjacent  node  on  both  ha'f  duplex  and  multipoint 
circuits.  This  ci)unter  is  used  as  a  statistical  base  for  the  evaluation  of  the 
counter  for  selection  timeouts.  The  overflow  value  is  fi5.5;U. 

Selection  timeouts 

This  counter  records  the  number  of  times  that  the  executor  turned  a  circuit 
around  or  selected  an  adjacent  node  on  both  half  duplex  and  multipoint 
circuits  but  the  adjacent  node  failed  to  respond  within  the  required  time.  This 
can  be  caused  by  blocks  being  lost  on  the  circuit  in  either  direction  or  by  too 
small  a  value  being  specifled  for  the  executor's  response  timer.  Blocks  are 
usually  lost  because  of  a  partial,  temporary,  or  total  failure  of  the  communica- 
tions line.  This  counter  can  have  the  following  qualifler:  no  reply  to  select. 
The  overflow  value  is  254. 


E.1.4    Data  Link  Layer:  Ethernet  Circuits 

Bytes  received 

This  counter  increments  when  a  data  byte  is  received  on  the  circuit.  The 
count  does  not  include  Da  ^  Link  Protocol  overhead  or  bytes  retransmitted  by 
the  Data  Link  laver.  It  can  be  u.sed  with  the  counter  or  data  blocks  received  to 
determine  the  inbound  trafflc  load  on  the  circuit.  The  overflow  alue  is 
4,294.967.294. 

Bytes  sent 

This  counter  increments  when  a  data  byte  is  .sent  on  the  circuit.  The  count 
does  not  include  Data  Link  Protocol  overhead  or  bytes  retransmitted  bv  the 


determine  the  outbound  trafflc  load  on  the  circuit.  The  overflow  value  is 
4,294,967,294. 


• 
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Data  blocks  received 

This  counter  increments  when  a  data  block  is  received  oii  the  circuit.  The 
counf  does  not  include  Data  Link  Pri)toc{)l  overhead.  This  counter  can  be  used 
as  a  statistical  base  tor  evaluating  the  other  Data  Link  layer  counters.  The 
overflow  value  is  4,294,967,294. 

Data  blocks  sent 

This  counter  increments  when  a  data  block  is  sent  on  the  circuit.  The  count 
does  not  include  Data  Link  Protocol  overhead  or  blocks  retransmitted  by  the 
Data  Link  layer.  It  can  be  used  as  a  statistical  base  for  evaluating  the  other 
Data  Link  layer  counters.  The  overflow  value  is  4.294,967.294. 

User  buffer  unav&ilable 

This  counter  indicates  the  total  number  of  times  that  no  user  buffer  was 
available  for  an  incoming  frame  that  passed  all  Altering.  I'ser  buffers  are 
supplied  by  users  on  receive  requests.  The  overflow  value  is  6o.r).'U. 

E.1.5    Data  Link  Layer:  X.25  Permanent  Virtual  Circuits  (PVCs) 
Bytes  received 

This  counter  indicates  the  number  of  bytes  of  data  received  over  the  circuit 
since  the  counter  was  last  zeroed.  The  overflow  value  is  4.294.967.294. 

Bytes  sent 

This  counter  indicates  the  number  of  bytes  of  data  sent  over  the  circuit  since 
the  counter  was  last  zeroed.  The  overflow  value  is  4.294.967.294. 

Data  blocks  received 

This  counter  indicates  the  number  of  data  blocks  received  over  the  circuit 
since  the  counter  was  last  zeroed.  The  overflow  value  is  4.294.967,294. 

Data  blocks  sent 

This  counter  indicates  the  number  of  data  blocks  sent  over  the  circuit  since 
th€  counter  was  last  zeroed.  The  overflow  value  is  4.294.967.294. 

Locally  initiated  resets 

This  counter  indicates  the  number  of  resets  sent  over  the  circuit  since  the 
counter  was  last  zeroed.  The  overflow  value  is  254. 

Network  initiated  resets 

This  counter  increments  when  a  reset  is  sent  by  the  PSN  and  is  received  by 
the  local  DTE  over  this  circuit.  The  overflow  value  is  254. 

Remotely  initiated  resets 

'^his  counter  indicates  the  number  of  resets  received  b}'  the  local  DTK  \^\\ 
wee  originated  by  a  remote  DTE  or  DTP^s  over  this  circuit.  The  overflow 
value  is  254. 
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E.2    Line  Counters 


There  are  five  groups  of  line  counters.  Four  groups  are  related  to  the  Data 
Link  layer  and  one  group  to  the  Network  Management  layer.  The  Data  Link 
layer  counters  are  divided  into  two  groups  that  are  device  oriented  and  two 
groups  that  are  line  oriented. 

E.2.1    Data  Link  Layer:  All  Devices  Except  DA,  DMC,  DMP,  PCL, 
UNA,  and  QNA 

Local  process  errors 

This  counter  increments  when  the  executor  is  responsible  for  a  processing 
fault.  On  a  multipoint  line,  the  counter  is  kept  as  a  total  only  for  the  control 
station,  not  for  each  tributary.  Although  the  fault  is  usually  caused  by  a 
programming  error  at  the  executor,  there  is  a  remote  possibility  that  it  could 
be  caused  by  a  line  error  that  was  not  detected  by  the  Data  Link  Protocol. 
This  counter  can  have  any  of  the  following  qualifiers:  NAKs  received,  header 
format  error:  NAKs  sent,  receive  overrun:  receive  overruns.  NAK  not  .sent. 
The  overflow  value  is  254. 

Remote  process  errors 

This  counter  increments  when  an  adjacent  node  is  responsible  for  a  processing 
fault.  On  a  multipoint  line,  the  counter  is  kept  as  a  total  only  for  the  control 
station,  not  for  each  tributary.  Although  the  fault  is  usually  caused  by  a 
programming  error  or  hardware  failure  at  the  adjacent  node,  there  is  a  remote 
possibility  that  it  could  be  caused  by  a  line  error  that  was  not  detected  by  the 
Data  Link  Protocol.  This  counter  can  have  any  of  the  followinj  qualifiers: 
NAKs  received,  receive  overrun;  NAKs  sent,  header  format  error:  selection 
address  errors;  streaming  tributary.  The  overflow  value  is  254. 

E.2.2   Data  Link  Layer:  PCL  Device 

Attempts  to  become  master 

This  counter  increments  when  an  attempt  to  become  the  master  on  the  PCL 
bus  fails  due  to  other  traffic  on  the  bus.  The  overflow  value  is  254. 

Device  errors 

This  counter  increments  when  the  executor  detects  faulty  hardware  operation 
on  its  own  UNIRUS.  This  counter  can  have  any  of  the  following  qualifiers: 
interrupt  timeout,  receiver  overflow/UNIBUS  timeout,  receiver  overrun, 
transmitter  overflow/UNIBUS  timeout,  transmitter  underrun.  The  overflow 
value  is  254. 
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Process  errors 

This  counter  increments  when  fauhy  operation  is  detected  by  the  executor  on 
one  of  the  other  nodes  on  the  PCL  bus  or  the  executor  itself.  The  overflow 
value  is  254.  This  counter  can  have  any  of  the  following  qualifiers: 

•  Flag  format  error  (indicates  a  programming  error  at  some  other  node) 

•  Multiplexer  address  error  (indicates  that  the  executor's  transmitter  is  not 
being  allowed  a  time  slice  on  the  bus;  usually  caused  by  a  hardware  installa- 
tion error) 

•  Unrecognized  receiver  error  (indicates  a  hardware  error  during  reception  of 
the  flag  portion  of  a  message) 

•  Unrecognized  station  error  (indicates  that  the  executor  is  missing  a  tribu- 
tary address  or  that  some  other  node  is  using  the  wrong  tributary  address  to 
identify  itself) 

E.2.3    Network  Management  Layer:  All  Lines  Except  DMC 
Seconds  since  last  zeroed 

This  counter  starts  when  the  other  line  counters  are  zeroed.  It  increments  by  2 
every  2  seconds.  This  counter  is  zeroed  when  the  other  line  counters  are 
zeroed,  so  as  to  provide  a  time  frame  for  them.  The  overflow  value  is  65,534. 

E.2.4   Data  Link  Layer:  Ethernet  Lines 
Blocks  sent,  initially  deferred 

This  counter  indicates  the  total  number  of  times  that  a  frame  transmission 
was  deferred  on  its  first  transmission  attempt.  It  is  used  to  measure  Ethernet 
contention  with  no  collisions.  The  overflow  value  is  4,294,967,294. 

Blocks  sent,  multiple  collisions 

This  counter  indicates  the  total  number  of  times  that  a  frame  was  successfully 
transmitted  on  the  third  or  later  attempt,  after  normal  collisions  on  previous 
attempts.  The  overflow  value  is  4,294,967,294. 

Blocks  sent,  single  collision 

This  counter  indicates  the  total  number  of  times  that  a  frame  was  succes.-iully 
transmitted  on  the  second  attempt  after  a  normal  collision  on  the  first  at- 
tempt. The  overflow  value  is  4,294,967,294. 

Bytes  received 

This  counter  increments  when  a  data  byte  is  received  on  the  line.  The  count 
does  not  include  Data  Link  Protocol  overhead  or  bytes  retransmitted  by  the 
Data  Link  layer.  It  can  be  used  with  the  counter  or  data  blocks  received  to 
determine  the  inbound  traffic  load  on  the  line.  The  overflow  value  io 
4,294,967,294. 
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Bytes  sent 

This  counter  increments  when  a  data  byte  is  sent  on  the  line.  The  count  does 
not  include  Data  Link  Protocol  overhead  or  bytes  retransmitted  by  the  Data 
Link  layer.  It  can  be  used  with  the  counter  or  data  blocks  received  to  deter- 
mine the  outbound  traffic  load  on  the  line.  The  overflow  value  is 
4,294.967.294. 

Collision  detect  check  failure 

This  counter  indicates  the  approximate  number  of  times  that  a  collision  de- 
tect was  not  sensed  after  a  transmission.  The  overflow  value  is  65,5.'U. 

Data  blocks  received 

This  counter  increments  when  a  data  block  is  received  on  the  line.  The  count 
does  not  include  Data  Link  Protocol  overhead.  It  can  be  used  as  a  statistical 
base  for  evaluating  the  other  Data  Link  layer  counters.  The  overflow  value  is 
4.294.967.294. 

Data  blocks  sent 

This  counter  increments  when  a  data  block  is  sent  on  the  line.  The  count  does 
not  include  Data  Link  Protocol  overhead  or  blocks  retransmitted  by  the  Data 
Link  layer.  It  can  be  used  as  a  statistical  base  for  evaluating  the  other  Data 
Link  layer  counters.  The  overflow  value  is  4,294.967.294. 

Data  overrun 

This  counter  indicates  the  total  number  of  times  that  the  hardware  lost  an 
incoming  frame  because  it  was  unable  to  keep  up  with  the  data  rate.  The 
overflow  value  is  65.534. 

Multicast  blocks  received 

This  counter  indicates  the  total  number  of  multicast  blocks  that  have  been 
successfully  received.  The  overflow  value  is  4,294,967,294. 

Multicast  bytes  received 

This  counter  indicates  the  total  number  of  multicast  data  bytes  that  have 
been  successfully  received  (including  bytes  in  the  Ethernet  data  field,  but  not 
the  Ethernet  data  link  headers).  The  overflow  value  is  4,294,967,294. 

Receive  failure 

This  counter  indicates  the  total  number  of  blocks  received  with  some  data 
error.  (The  blocks  are  data  frames  that  passed  either  physical  or  multica.st 
address  comparison.)  For  each  increment  of  the  counter,  one  of  the  following 
types  of  failure  is  recorded:  block  check  error,  framing  error,  frame  too  long. 
The  overflow  value  is  65,534. 

Send  failure 

This  counter  indicates  the  total  number  of  times  that  a  transmit  attempt 
failed.  For  each  increment  of  the  counter,  me  of  the  following  types  of  failure 
is  recorded:  carrier  check  failed,  excessive  collisions,  frame  too  long,  open 
circuit,  remote  failure  to  defer,  short  circuit.  The  overflow  value  .s  65.534. 
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System  buffer  unavailable 

This  counter  indicates  the  total  number  of  times  that  no  system  buffer  was 
available  for  an  incoming  frame.  This  can  be  any  buffer  between  the  hardware 
and  the  user  buffers  (those  supplied  on  receive  requests).  The  overt!- w  value 
is  65,534. 

Unrecognized  frame  destination 

This  counter  indicates  the  number  of  times  that  a  frame  was  discarded  be- 
cause there  was  no  enabled  portal  with  the  protocol  type  or  multicast  address. 
The  count  includes  frames  received  for  the  physical  address,  broadcast  ad- 
dress, or  multicast  address.  The  overflow  value  is  65,534. 

E.2.5    Data  Link  Layer:  LAPB  Lines 

Bytes  received 

This  counter  increments  when  a  data  byte  is  received  on  the  line.  The  count 
does  not  include  Data  Link  Protocol  overhead  or  bytes  retransmitted  by  the 
Data  Link  layer.  It  can  be  used  with  the  counter  or  data  blocks  received  to 
determine  the  inbound  traffic  load  on  the  line.  The  overflow  value  is 
4.294.967,294. 

Bytes  sent 

This  counter  increments  when  a  data  byte  is  sent  on  the  line.  The  count  does 
not  include  Data  Link  Protocol  overhead  or  bytes  retransmitted  by  the  Data 
Link  layer.  It  can  be  used  with  the  counter  or  data  blocks  received  to  deter- 
mine the  outbound  traffic  load  on  the  line.  The  overflow  value  is 
4.294.967,294. 

Data  blocks  received 

This  counter  increments  when  a  data  block  is  received  on  the  line.  The  count 
does  not  include  Data  Link  Protocol  overhead.  It  can  be  used  as  a  statistical 
base  for  evaluating  the  other  Data  Link  layer  counters.  The  ove  -flow  value  is 
4.294.967.294. 

Data  blocks  sent 

This  counter  increments  when  a  data  block  is  sent  on  the  line.  The  count  does 
not  include  Data  Link  Protocol  overhead  or  blocks  retransmitted  by  the  Data 
Link  layer.  It  can  be  used  as  a  statistical  base  for  evaluating  the  other  Data 
Link  layer  counters.  The  overflow  value  is  4,294,967.294. 

Data  errors  inbound 

This  counter  indicates  the  number  of  incoming  data  errors  resulting  from 
faults  on  the  channel  between  the  local  DTE  and  the  DCE.  The  counter  can 
have  any  of  the  following  qualifiers:  block  too  long,  block  check  error,  reject 
sent.  The  overflow  value  is  254. 

Data  errors  outbound 

This  counter  indicates  the  number  of  outgoing  data  errors  resulting  from 
faults  on  the  channel  between  the  local  DTP2  and  the  DCE.  It  can  include  the 
following  qualifier:  reject  received.  The  overflow  value  is  254. 
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Local  buffer  errors 

This  counter  increments  when  a  receive  not  ready  (HNH)  packet  is  sent.  It  can 
include  the  following  (lualifier:  HNH  sent,  hulter  unavailable.  The  overflow 
value  is  2 '14. 

Local  process  errors 

This  counter  increments  when  a  frame  reject  error  (FHMH)  is  received  over 
the  line  or  when  your  system  is  overloaded.  The  counter  can  have  any  of  the 
following  qualifiers:  transmit  underrun;  receive  overrim;  FHMIi  received, 
header  format  error.  Normally,  the  first  two  qualifiers  indicate  that  the  sys- 
tem is  overloaded,  while  the  third  indicates  that  the  HSX  11  PSI  software  is 
malfunctioning.  The  overflow  value  is  '1^^A. 

Local  reply  timeouts 

This  counter  increments  when  the  retransmit  timer  for  that  line  expires.  The 
overflow  value  is  '2r)A. 

Remote  buffer  errors 

This  counter  increm.ents  when  a  receive  not  ready  (HNH)  packet  is  received.  It 
can  include  the  following  qualifier:  HNH  received,  buffer  unavailal)le.  The 
overflow  value  is  2')4. 


Remote  process  errors 

This  counter  increments  when  an  invalid  next  expected  secjuence  number 
(N(H))  and  a  frame  reject  error  (FHMH)  are  sent  over  the  line.  The  counter 
can  have  any  of  the  following  qualifiers:  invalid  N(H)  received:  FHMH  sent, 
header  format  error.  I'sually  these  errors  indicate  that  the  DCK  is  malfunc- 
tioning. The  overflow  value  is  254. 

Remote  reply  timeouts 

This  counter  indicates  the  number  of  times  that  a  frame  with  the  poll  bit  .set 
has  been  received  over  the  line  that  is.  the  number  of  errors  resulting  from 
faults  on  the  line.  The  overflow  value  is  254. 
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E.3    Module  Counters 


1  htTi'  arc  two  \\\)v>  ot  module  counters:  protocol  nxxlulc  coutitcrs  and  server 
module  I'ounter^.  The  protocol  mo(iulc  i>  the  X.J'i  protocol  fiiodulc  The 
server  module^  arc  the  .\,J.'>  scr\-cr  and  tlie  \  _'^»  server  niodidcx. 


• 


• 


E.3.1    X.25  Protocol  Module 
Bytes  received 

'I'his  counter  iniTement>  when  a   byte   i>  received   by   the  local   DTK.  The 
overflow  \alue  is  l.-'^>4.9<r.294. 

Bytes  sent 

This  counter  increments  when  a  byte  i-  >ent  by  the  local  DTK.  The  overllow 
value  i.s  1.294.%7._;M. 

Calls  received 

Thi>  counter  increment^  \s  hen  an  iiuomini:  lall  i>  received  b>  the  DTK.  'I'he 
<ivertlow  value  i>  b.').."io4. 

Calls  sent 

This  counter  increments  when  an  out^ntinL'  call  i>  sent    T\w  overflow  value  is 
fin.  o;  14. 

Data  blocks  received 

This  counter  increments  when  a  data  block  is  received  by  the  local  DTFl.  The 
overflow  value  is  4.294.9b7.294. 

Data  blocks  sent 

This  counter  increments  when  a  data  i)lock  is  sent  by  the  local  DTK.  The 
overflow  value  is  4.294.9(i7.294. 

Fast  selects  received 

This  counter  increments  when  a  call  is  received  with  the  fast  select  facility 
specified,  'llie  overflo.v  value  is  (v).r);i4. 

Fast  selects  sent 

This  counter  increments  when  a  call  is  sent  with  the  last  select  facility  speci- 
fied. The  overflow  value  is  (ir),r);ii. 

Locally  initiated  resets 

This  counter  increments  when  a  reset  i>  sent  b>  the  local  D'I'K.  The  overflow- 
value  is  2")4. 
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Maximum  channels  active 

This  counter  indicates  the  number  of  switched  virtual  circuits  that  were  ac- 
tive at  any  one  time  since  the  counters  were  last  zeroed.  Theso  circuits  are 
ones  whose  logical  channel  numbers  appear  in  the  channel  list  regardless  of 
whether  or  not  the  circuits  are  used  for  incoming  or  outgoing  calls.  The  over- 
flow value  is  65,534. 

Maximum  switclied  circuits  active 

This  counter  indicates  the  number  of  switched  virtual  circuits  that  were  ac- 
tive at  any  one  time  since  the  counters  were  last  zeroed.  The  overflow  value  is 
65,534. 

Networlc-initiated  resets 

This  counter  increments  when  a  reset  is  sent  by  the  PS\  and  is  received  by 
the  local  DTE.  The  overflow  value  is  254. 

Received  cali  resource  errors 

This  counter  increments  when  an  incoming  call  is  rejected  because  of  insuffi- 
cient resources.  The  overflow  value  is  65.534. 

Remoteiy  initiated  resets 

This  counter  indicates  the  number  of  resets  received  by  the  local  DTE  that 
were  originated  by  a  remote  DTE  or  DTEs.  The  overflow  value  is  254. 

Restarts 

This  counter  indicates  the  number  of  times  that  the  restart  procedure  was 
used  on  the  DTE.  The  overflow  value  is  254. 

Seconds  since  iast  zeroed 

This  counter  starts  when  the  other  protocol  module  counters  are  zeroed.  It 
increments  by  2  every  2  seconds.  This  counter  is  zeroed  when  the  other  proto- 
col module  counters  are  zeroed,  so  as  to  provide  a  time  frame  for  them.  The 
overflow  value  is  65.534. 


E.3.2    X.25/X29  Server  Modules 

Incoming  calls  rejected,  no  resources 

This  counter  indicates  the  number  of  times  that  the  incoming  call  handler 
rejected  a  request  to  set  up  a  virtual  circuit  because  of  insufficient  resources. 
The  overflow  value  is  254. 

Logical  links  rejected,  no  resources 

This  counter  increments  each  time  that  a  logical  link  could  not  be  established 
because  of  insufficient  resou'lres.  The  overflow  value  is  254. 

Maximum  circuits  active 

This  counter  indicates  the  number  of  switched  virtufJ  circuits  that  have  been 
set  up  since  the  counters  were  last  zeroed.  'I'he  overflow  value  is     ).534. 
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Seconds  since  last  zeroed 

This  counter  starts  when  the  other  server  module  counterr.  are  zeroed.  It 
increments  by  2  every  2  seconds.  This  counter  is  zeroed  when  the  other  server 
module  counters  are  zeroed,  so  as  to  provide  a  time  frame  for  them.  The 
overflow  value  is  fin.rS.'U. 


E.4    Node  Counters 


E.4.1    Network  Management  Layer 
Seconds  since  last  zeroed 

This  counter  starts  when  the  other  node  counters  are  zeroed.  It  increments  by 
2  every  2  seconds.  This  counter  is  zeroed  when  the  other  node  counters  are 
zeroed,  so  as  to  \.  ovide  a  time  frame  for  them.  The  overflow  value  is  (So.o.'U. 

E.4. 2    Network  Services  Layer 

Bytes  received 

This  counter  increments  when  user  data  bytes  are  received  from  the  associ- 
ated node  at  the  logical  link  level.  It  includes  only  the  user  data  from  data 
mes'^ages  and  from  interrupt,  connect,  accept,  reject,  disconnect,  and  abort 
functions.  The  overflow  value  is  4.294.967.294. 

Bytes  sent 

This  counter  increments  when  user  data  bytes  are  sent  to  the  associated  node 
at  the  logical  link  level.  It  includes  only  the  acknowledged  user  data  from  data 
messages  and  from  interrupt,  connect,  accept,  reject,  disconnect,  and  abort 
functions.  It  does  not  include  retransmissions.  The  overflow  value  is 
4.294.967.294. 

Connects  received 

This  counter  increments  when  a  connect  initiation  signal  is  received  from  the 
associated  node.  The  overflow  value  is  65.534. 

Connects  sent 

This  counter  increments  when  a  connect  initiation  signal  is  .sent  to  the  associ- 
ated node.  The  overflow  value  is  65.5.S4. 

Messages  received 

This  counter  increments  when  a  message  is  received  from  the  associated  node 
at  the  lo'^ical  link  level.  The  count  includes  both  user  messages  and  logical 
link  protocol  control  messages.  Furthermore,  it  includes  internal  segmenta- 
tion of  user  messages  by  the  Network  Services  layer.  The  overflow  value  is 
4.294.967,294. 
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Messages  sent 

This  counter  increments  when  a  message  is  sent  to  the  associated  node  at  the 
logical  link  level.  The  count  includes  both  user  messages  and  logical  link 
protocol  control  messages.  It  also  includes  the  retransmission  of  a  message. 
The  Network  Services  layer  segments  the  user  mes.sages.  The  overflow  value  is 
4.294.%7.294. 

Node  maximum  logical  linl(s  active 

This  counter  records  the  number  of  active  links  between  the  executor  and  the 
associated  node.  The  overtlow  value  is  (^o.fi.'U. 

Received  connect  resource  errors 

This  counter  increments  when  the  executor  attempts  to  rejec*  a  connect  initi- 
ation signal  from  the  associated  node  due  to  lack  of  resources  in  the  executor. 
This  condition  occurs  when  there  are  not  enough  maximum  links  allowed  or 
when  there  are  not  enough  control  buyers  or  small  buffers.  The  overflow  value 
is  65.5;U. 

Response  timeouts 

This  counter  increments  when  the  associated  node  fails  to  respond  within  the 
required  time.  This  situation  can  be  caused  either  by  messages  being  dis- 
carded in  the  network  (see  Section  K.1.2)  or  by  a  wide  variance  in  the  round- 
trip  delay  to  the  node.  This  condition  normally  indicates  an  overload  condi- 
tion in  the  network.  This  should  be  considered  a  problem  if '2  percent  or  more 
of  the  messages  sent  are  timed  out.  The  overflow  value  is  Go.o.'M. 

Total  maximum  logical  links  active 

This  counter  records  the  number  of  active  logical  links  between  the  executor 
and  all  nodes  (including  itself).  This  counter  is  included  in  counters  for  the 
executor  node  only.  The  overflow  value  is  Bo.o.'U. 

Total  received  connect  resource  errors 

This  counter  increments  when  the  executor  attempts  to  reject  an  initiation 
signal  from  any  node  due  to  the  lack  of  resources  in  the  executor.  This  counter 
is  included  in  counters  for  the  executor  node.  The  condition  is  caused  by  the 
maximum  logical  link  parameter  being  set  too  low  or  by  the  number  of  buffers 
parameter  set  too  low  for  control  buffers  or  small  buffers.  The  overflow  value 
is  65,534. 


E.4.3    Executor  Node  Counters 
Aged  packet  loss 

This  counter  increments  when  a  packet  is  discarded  due  to  visiting  too  many 
nodes.  The  count  is  the  total  of  all  such  discards  by  the  executor  node.  Only 
routing  nodes  keep  this  counter.  This  counter  is  incremented  each  time  the 
aged  packet  loss  event  occurs.  The  overflow  value  is  254. 


E-14       DECnet-RSX  System  Manager's  Guide 


Node  out  of  range  packet  loss 

This  counter  increments  when  a  packet  is  discarded  hecause  the  destination 
node  address  was  j^reater  than  the  niaxinuim  address  defined  for  the  executor. 
The  count  is  the  total  ol'all  such  (Hscards  by  the  executor  node.  Only  routing 
nodes  keep  this  counter.  This  c(»unter  is  incremented  each  time  the  node  out 
of  range  packet  loss  event  occurs.  The  overflow  value  is  2")4. 

Node  unreachable  packet  loss 

This  counter  increments  when  a  packet  is  discarded  because  its  destination 
node  was  unreachable.  The  count  is  the  total  of  all  such  discards  by  the 
executor  node.  Only  routing  nodes  keep  this  counter.  The  counter  is  incre- 
mented each  time  the  node  unreachable  packet  loss  event  occurs.  The  over- 
How  value  is  Ho.o.'U. 

Oversized  packet  loss 

This  counter  increments  when  a  packet  's  discarded  because  it  was  larger  than 
the  circuit  buffer  size.  The  circuit  buffer  size  was  previously  established  be- 
tween the  executor  node  and  the  adjacent  node.  Only  routing  nodes  keep  this 
counter.  The  counter  is  incremented  each  time  the  oversized  packet  loss  event 
occurs.  The  overflow  value  is  2')4. 

Packet  format  error 

This  counter  increments  when  a  packet  is  discarded  because  of  invalid  packet 
control  information.  The  count  is  the  total  of  all  such  discards  by  the  executor 
node.  This  counter  is  incremented  each  time  the  packet  formal  error  event 
occurs.  The  overflow  value  is  2.'i4. 

Partial  routing  update  loss 

This  counter  increments  when  part  of  a  routing  update  is  lost  becau.^e  it 
contained  a  reachable  node  address  that  exceeded  the  maximum  address 
defined  for  the  executor  node.  The  count  is  the  total  of  all  such  occurrences  at 
the  executor  node.  Only  routing  nodes  keep  this  counter.  This  counter  is 
incremented  each  time  the  partial  routing  update  loss  event  occurs.  The  over- 
flow value  is  254. 

Verification  reject 

This  counter  increments  when  the  executor  rejects  a  verification  request  from 
an  adjacent  node  during  routing  initialization.  'I  he  count  is  rhe  total  of  all 
such  occurrences  at  the  executor  node.  Thi>  counter  is  incremented  each  time 
the  verification  reject  event  occurs.  The  overflow  value  is  2.")4. 
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E.5    System  Counters 


There  are  five  system  counters:  tour  butter  allocation  failure  counters  and  one 
timing  counter.  Anv  ot  the  following  buffer  allocatit)n  failures  can  be  resolved 
using  CFE.  Ise  the  CFK  LIST  SVSTKM  rHAHA('TEHISTI(\S  command  to 
determine  the  present  setting  of  the  buffer  in  question.  Then,  use  the  CVK 
DEFINE  SVSTFIM  command  to  increase  the  number  of  those  butters.  Alter 
the  n'^mber  of  buffers  is  increased,  reload  DECnet. 

Control  buffer  allocation  failed 

This  counter  increments  when  a  control  buffer  allocation  tails.  This  condition 
is  caused  by  not  having  enough  control  butters  to  service  the  work  load  on  the 
Communications  Flxecutive  and  its  processes.  The  overtlovv  value  is  (io.n.U. 

Large  buffer  allocation  failed 

This  counter  increments  when  a  large  butter  allocation  tails.  This  condition  is 
caused  by  not  having  enough  large  butters  available  to  service  the  work  load 
on  the  Communications  Executive  and  its  processes.  It  can  also  be  a  symptom 
of  the  minimum  receive  butter  level  reserving  too  many  large  butlers.  The 
overtlow  value  is  6").5;^. 

Receive  buffer  allocation  failed 

This  counter  increments  when  a  receive  butter  allocation  tails.  This  condition 
is  caused  by  not  having  enough  receive  butters  reserved  from  the  large  butters 
to  service  the  work  load  on  the  Communications  Executive  and  its  processes. 
The  overtlow  value  is  65,534. 

Seconds  since  last  zeroed 

This  counter  starts  when  the  other  system  coimters  are  zeroed.  It  increments 
by  2  every  2  seconds.  This  counter  is  zeroed  when  the  other  system  counters 
are  zeroed,  so  as  to  provide  a  time  trame  tor  them.  The  overtlow  value  is 
65.5:U. 

wmall  buffer  allocation  failed 

This  counter  increments  when  a  small  butter  allocation  fails.  This  condition  is 
caused  when  there  are  not  enough  small  butters  to  service  the  work  load  on  the 
Communications  Flxecutive  and  its  processes.  The  overtlow  value  is  (i5.5.'M. 
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Appendix  F 

Network  Parameter  and  Counter  Type  Numbers 


Flvery  parameter  or  counter  affected  by  the  SET.  CLEAR,  or  SHOW  com- 
mands across  the  network  is  assijjned  a  type  number.  This  appendix  hsts 
these  type  numbers  as  recognized  by  DECnet-RSX  network  management 
software  for  all  component  parameters  and  counters  (where  applicable  I. 
Counter  and  parameter  type  numbers  from  23(M)  to  2499  are  RSX  system 
specific.  Appendix  K  provides  detailed  descriptions  of  network  counters.  The 
I).\A  .\rtuork  Mananrmcnt  Functional  Specification  describes  all  standard 
type  numbers  for  all  parameters  and  counters. 

This  appendix  also  lists  the  event  types  supported  for  the  DECnet-RSX  log- 
ging component.  Appendix  D  provides  detailed  descrij)tions  of  event  classes 
and  types. 

Parameter  counter  type  numbers  appear  in  displays  of  information  from  re- 
mote nodes  that  are  not  able  to  transmit  the  it- xt  description  of  a  parameter  or 
counter.  A  non-RSX  node  running  NCR  prints  the  type  numbers  if  it  cannt)t 
recognize  them.  For  example,  if  you  were  on  a  VMS  node,  you  could  set  the 
executor  to  RSX  node  BOS  and  issue  the  following  command: 


NCP 


PC: 


The  system  would  then  display  the  characteristics  of  circuit  FCL-O.O: 

CircMit  '.'olaiile  Ct^  a  r  ac  t  e  r  i  s  t  i  c  s  as  of  ll-AuG-l9e3  21:3':':3a 
C  1  r  c  J  1  t  =  P  C  L  -  0  .  0 


Cost 

Hello  timer 
L  1  s  t  e  ri  time 
0  w  ri  e  r 

Type 

T  r  1  b  M  t  a  r  / 


=  3 

=  15 

=  30 

=  ;<  P  T 

=  DDCMP  control 


F.1    Alias  Parameters  (RSX  system  specific) 

Number  Keywords 


1(X) 
110 


SCOPK 
DKSTINATION 


F-1 


F.2    Circuit  Parameters  and  Counters 


F.2.1    Circuit  Parameters 


Number 

0 

I 

110 

4(H) 

8(K) 

810 

900 

902 

90«i 

907 

920 

921 

927 
IKX) 
1111 
1112 
1121) 
1121 
1122 
112.^ 
1140 
2320 


Keywords 

STAIK 
siihstatr 

COrNIKR  riMKH 
I.OOl'BACK  NAMK 
ADIACKN  1   NODK 
KI.OCK  SIZK 

rosT 

HOITKH  PKIOHITY 

HKl.LO  TIMKH 

LIS  IK  N  TIMKH 

MAXINUM  HKCAI.LS 

HKCALI.  TIMKH 

MAXIM  I'M  HHOADCASr  HOITKHS 

OWNKH 

I  "SACK 

TYI'K 

It .  i\ 

CHANNKL 

MAXIMl  M  DATA 

MAXIMIM  WINDOW 

IKIBITAHV 

MlLTIPOlNr  ACriVK  iHSX  ^pecilui 


F.2.2    Circuit  Counters 

Some  counters  include  qualifiers  identified  by  hit  numbers  ni  a  bit  mask. 
These  qualifiers  are  included  in  the  following;  lists,  indented  under  the  counter 
to  which  they  belong. 

The  following  counters  are  kept  for  all  circuits: 
Number  Standard  text 


tf 


0 
8(K) 
801 
805 
810 
811 
812 
820 
821 


SeconcN  since  last  zeroed 
Terminating;  packets  reieived 
Onumatinn  packets  >ent 
('(irruptii)n  loss 
Transit  packets  recei\e(l 
Transit  packets  sent 
Transit  con^res'ion  li'"' 
Circuit  down 
Initialization  tailure 


F-S 
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^^                                        The  following  counters  are  kept  for  DDCMP  circuits: 

^^r                                           Number 

Standard  text 

1(XK1 

Bytes  received 

1(H)1 

E^ytes  sent 

1010 

Data  blocks  received 

1011 

Data  blocks  sent 

1020 

Data^rrors  inbound 

1  NAKs  sent,  data  field  block  check  error 

2  NAKs  sent.  REP  response 

1021 

Data  errors  outbound 

0  NAKs  received,  header  block  check  error 

1  NAKs  received,  data  field  block  check  error 

2  NAKs  received.  REP  response 

io;u) 

Remote  reply  timeouts 

lOMl 

Local  reply  timeouts 

1040 

Remote  buffer  errors 

0  NAKs  received,  buffer  unavailable 

1  NAKs  received,  buffer  too  small 

^y 

Local  buffer  errors 

0  N.AKs  sent,  buffer  unavailable 

1  NAKs  sent,  buffer  too  small 

lOnO 

Selection  intervals  elapsed 

lOol 

Selection  timeouts 
0    No  reply  to  select 

The  following  counters  are  kept  for  Ethernet  circuits: 

^^                                           Number 

Standard  text 

^y 

Bytes  received 

1001 

Bytes  sent 

1010 

Data  blocks  received 

1011 

Data  blocks  sent 

lo^r, 

I'ser  buffer  unavailable 

The  foUowi 

ng  counters  are  kept  for  permanent  X.25  circuits: 

Number 

Standard  text 

^^                                                   KXX) 

Bytes  received 

^y                                                   1(K)1 

Bytes  sent 

1010 

Data  blocks  received 

1011 

Data  blocks  sent 

1240 

Locally  initiated  resets 

1241 

Remotely  initiated  resets 

1242 

Network-initiated  resets 

• 

Network  Parameter  and  Counter  Type  Numbers 
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F.3    Line  Parameters  and  Counters 


F.3.1    Line  Parameters 


Number 


Keywords 


0 

STATE 

1 

substate 

100 

SERVICE 

no 

COUNTER  TIMER 

nil 

DUPLEX 

1112 

PROTOCOL 

1151 

DEAD  TIMER 

1152 

DELAY  TIMER 

2300 

OWNER 

(RSX  specific) 

2310 

CONTROLLER  CSR 

(RSX  specific) 

2311 

UNIT  CSR 

(RSX  specific) 

2312 

VECTOR 

(RSX  specific) 

2313 

PRIORITY 

(RSX  specific) 

2321 

MULTIPOINT  DEAD 

(RSX  specific) 

2330 

LOCATION 

(RSX  specific) 

F.3. 2   Line  Counters 

Some  counters  include  qualifiers  identified  by  bit  numbers  in  a  bit  mask. 
These  qualifiers  are  included  in  the  following  lists,  indented  under  the  counter 
to  which  they  i  elong. 

The  following  counters  are  kept  for  point-to-point  and  tributary  DDCMP 
lines: 

Number  Standard  text 

0  Seconds  since  last  zeroed 

1100  Remote  process  errors 

0  NAKs  received,  receive  overrun 

1  NAKs  sent,  header  format  error 

2  Selection  address  errors 

3  Streaming  tributary 

1101  Local  process  pfors 

0  NAKs  sen  I,  receive  overrun 

1  Receive  overruns.  NAK  not  sent 

3    NAKs  received,  header  format  error 

DDCMP  software  does  not  support  the  following  counters  as  specified  by  the 
network  arciiitecture: 

•  NAKs  sent,  header  block  check  error:  bit  0  for  data  errors  inbound. 

This  is  counted  as  a  data  error,  under  bit  1,  due  to  information  not  returned 
by  driver. 

•  NAKs  sent,  buffer  unavailable:  bit  0  for  local  buffer  errors. 
This  is  not  sensed  by  driver. 
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•  Incomplete  reply  to  select:  bit  1  for  selection  timeouts. 

This  is  counted  as  a  no  reply,  under  bit  0.  due  to  information  not  sensed  by 
driver. 

•  Transmit  underruns:  bit  2  for  local  process  errors. 

The  driver  returns  a  device  timeout  error,  which  is  then  recorded  as  a  no 
reply  to  select  (bit  0  for  selection  timeouts)  if  the  line  is  multipoint  or  half 
duplex.  Otherwise  it  is  not  counted. 

The  following  counters  are  kept  for  the  PCL  device: 
Number  Standard  text 

0  Seconds  since  last  zeroed 

2410  Attempts  to  become  master 

2411  Process  errors 

0  I'nrecopnized  receiver  error 

1  Unrecognized  station  error 

2  Flag  format  error 

.'^    Multiplexer  address  error 

2412  Device  errors 

0  Transmitter  underrun 

1  Transmitter  overflow/T'NIBl'S  timeout 

2  Receiver  overrun 

3  Receiver  overflow/iNIBrS  timeout 

4  Interrupt  timeout 

The  following  counters  are  kept  for  Ethernet  lines  (UNA  and  QNA): 
Number  Standard  text 


0 

1000 
1(K)1 
1002 
1010 
1011 
1012 

101  :^ 

1014 
lOlo 
1060 


1061 
1062 


106:3 

1064 
1065 


Seconds  since  last  zeroed 

Bytes  received 

Bytes  sent 

Multicast  bytes  received 

Data  blocks  received 

Data  blocks  sent 

Multicast  blocks  received 

Blocks  sent,  initially  deferred 

Blocks  sent,  single  collision 

Blocks  sent,  multiple  collisions 

Send  failure 

0  Excessive  collisions 

1  Carrier  check  failed 

2  Short  circuii 
■^    Open  circuit 

4    Frame  too  long 

o    Remote  failure  to  defer 
Collision  detect  check  failure 
Receive  failure 

0  Block  check  error 

1  Framing  error 

2  Frame  too  long 
I'nrecognized  frame  destination 
Data  overrun 

Svstem  buffer  unavailable 


Network  Parameter  and  Counter  Type  Numbers       F~5 


The  following  counters  are  kept  for  LAPB  lines: 
Number  Standard  taxt 


{) 

Seconds  since  last  zeroed 

UKX) 

Bytes  received 

1001 

Bytes  sent 

1010 

Data  blocks  received 

1011 

Data  blocks  sent 

1020 

Data  errors  inbound 

3    Block  too  long 

4    Block  check  error 

">    RK.I  sent 

1021 

Data  errors  outbound 

3    RK.I  received 

1030 

Remote  reply  timeouts 

1031 

Local  reply  timeouts 

1040 

Remote  buffer  errors 

2    RNR  received,  butler  unavailable 

1041 

Local  buffer  errors 

2    RNR  sent,  buffer  unavailable 

IKK) 

Remote  process  errors 

4    In  Valid  N(R)  received 

r>    FRMR  sent,  header  format  error 

1101 

Local  process  errors 

2    Transmit  underrun 

4    Receive  overrun 

5    FRMR  received,  header  format  error 

F.4    Logging  Parameters  and  Events 
F.4.1    Logging  Parameters 

Number  Keywords 


0 

ST.ATK 

100 

NAMK 

2(K) 

SINK  NODK 

201 

FAENTS 

F.4. 2    Logging  Events 

Most  of  the  following  events  occur  on  both  routing  and  nonrouting  nodes. 
Events  that  occur  only  on  routing  nodes  are  flagged  with  an  asterisk.  See 
Appendix  D  for  descriptions  of  these  events. 


Number 

Standard  text 

0.0 

Kvent  records  lost 

0.1 

.Automatic  node  counters 

0.2 

Automatic  line  counters 

0.3 

.Automatic  line  service 

0.4 

Line  coiiriters  zeroed 

0.5 

Node  counters  zeroi'd 

0.6 

Passive  l(»opl)ack 

0.7 

Aborted  service  request 

0.8 

.Automatic  counters 

0.9 

Counters  zeroed 
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2.0 
2.1 
3.0 
3.1 

3.2 

4.0  • 

4.1  • 

4.2  • 
4.3 
4.4 
4..=)  ' 
4.6 
4.7 
4.8 
4.9 
4.10 
4.11 
4.12 

4.i;^ 

4.14 
4.1.^ 
4.16 

4.1H 

4.19 

.5.0 

n.l 

^.2 

.5.3 

.5.4 

.5.5 

0.6 

5.7 

5.8 

5.9 

5.10 

5.11 

5.12 

5.1.1 

5.14 

5.15 

6.0 

6.1 

6.2 

6.M 

6.4 

6.5 

64.1  • 

H4.2  • 

HM  14 

94.0 

96.0 


I.,(>ch1  node  state  change 

.Ac^^ess  ccntrol  failure 

Invalid  message 

Invalid  flow  {-ontrol 

Node  data  base  reused 

.Aged  ()acket  loss 

Node  unreachable  pa'  ket  lo.ss 

Node  out  of  range  p;i..ket  loss 

(A-ersized  packet  loss 

f'acket  fo!'nat  error 

Partial  routing  update  loss 

Verification  rejeit 

Circuit  down   circuit  tault 

Circuit  down,  software  fault 

Circuit  down,  operator  fault 

Circuit  up 

Circuit  initialization  failure,  circuit  fault 

Circuit  initiali/atmn  taiiure.  software  fault 

Circuit  initialization  failure,  operator  fault 

Ni>de  reachability  change 

.Adjacencv  up 

.•\diacenc\  reiected 

.Adiai encv  down 

.Adjacency  down        operator  initiated 

Locally  initiated  ^tate  change 

Remotely  initiated  state  change 

Protocol  restart  received  in  maintenance  mode 

Send  error  threshold 

Receive  error  thre^^hold 

Select  error  tbrexhold 

Block  header  format  error 

Selection  add'-es>  error 

Streaming  tributary 

Local  buffer  too  >mall 

Restart 

State  change 

Retransmit  maximum  exceeded 

Initialization  failure 

Send  failed 

Receive  tailed 

Data  set  readv  transmission 

Ring  indicator  transmission 

Cnexpected  carrier  transmission 

.\-emor\  access  error 

Communications  interface  error 

Performance  error 

Routing  database  corrupt 

Routing  database  restored 

Normal  usage  terminated 

DCF'  detected  packet  error 

State  c  hange 


Network  Parameter  and  Counter  Type  Numbers 


F-7 


F.5    Node  Parameters  and  Counters 


F.5.1    Node  Parameters 


Number 


Keywords 


0 

STATK 

100 

IDENTIFICATION 

101 

MANAC.KMK.NT  VERSION 

114 

HARDWARE  ADDRESS 

115 

SERVICE  NODE  VERSION 

120 

LOAD  FILE 

121 

SECONDARY  LOADER 

122 

TERTIARY  LOADER 

123 

DIAC.NOSTK^  FILE 

125 

SOFTWARE  TYPE 

130 

DIMI'FILE 

135 

DlNir  ADDRESS 

136 

DIMP  COINT 

14() 

Hosr 

141 

HOST 

150 

LOOP  COINT 

151 

LOOI'  LENC.TH 

152 

LOOP  WITH 

154 

LOOP  HELP 

500 

NAME 

501 

CIRCriT 

502 

ADDRESS 

600 

ACTIVE  LINKS 

601 

DELAY 

700 

NSP  VERSION 

710 

MAXIMIM  LINKS 

810 

TYPE 

820 

COST 

821 

HOPS 

822 

CIR(riT 

830 

NEXT  NODE 

900 

ROITINC.  VERSION 

901 

TYPE 

910 

ROrTIN(:  TIMER 

911 

SIBADDRESSES 

912 

BROADCAST  ROlTINC.  TIMER 

920 

MAXIMIM  ADDRESS 

921 

MAXIMIM  CIRCriTS 

922 

MAXIMIM  COST 

923 

MAXIMUM  HOPS 

924 

MAXIMIM  VISITS 

92H 

MAXIMIM  BROADCAST  NONROLTERS 

932 

SEC.MENl  BIFFER  SIZE 

230() 

RECEIVE  PASSWORD              iRSX  -perifu* 

2301 

TRANSMIT  PASSWORD          'RSX  >pe(ific) 

2310 

VERIFICATION  S'TATE            (RSX  specifu  > 
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F.5.2    Node  Counters 

Most  node  counters  are  kept  on  both  routing  and  nonroiitin^  nodes.  Counters 
that  are  kept  only  on  routing  nodes  are  llag^'ed  with  an  asterisk. 


Number 

Standard  text 

• 

0 

Seconds  oiruc  last  zerm'd 

fiOT) 

H\fc«-  received 

(;ni 

Bvte>  sent 

tUO 

Messatres  received 

rtll 

Mes-a^es  sent 

»i_'<) 

Connects  received 

H21 

Connects  sent 

H.^d 

Hesfxinse  timeouts 

7<K) 

Total  niaxiniiini  loyual  links  acti\e 

71(1 

|{eiei\ed  connect  resource  errors 

i«KI    • 

A^:ed  packet  loss 

fXi!   • 

Node  unrt      hable  packet  loss 

Cj,,o    . 

Node  out  oi  range  packet  loss 

^¥):\  ' 

Oversized  packet  loss 

91< 

Packet  format  error 

920  • 

Partial  routing  update  loss 

9:U( 

Verification  reject 

IMM\ 

Node  niaxinnim  logical  links  acti\e 

lAU) 

Total  received  connect  resource  error 

F.6    Object  Parameters  (RSX  system  specific) 

Number  Keywords 


Vio 

N.AMK 

MO 

COPIKS 

Ml 

[>KH 

")2<  > 

\Kf^IFIC\TI()N 

F.7    Process  Parameters  (RSX  system  specific) 

Number  Keywords 


(1 

STATK 

10 

LOCATION 

20 

MAXIMCM  LINKS 

21 

MAXIMIM  rONTHOLLKKS 

1,1) 

PAKTiriON 
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F.8   System  Parameters  and  Counters  (RSX  system  specific) 
F.8.1    System  Parameters 


Number  Keywords 

10  ACTIVE  CONTROL  BUFFERS 

20  ACTIVE  SMALL  BUFFERS 

30  ACTIVE  LARGE  BUFFERS 

110  MAXIMUM  CONTROL  BUFFERS 

120  MAXIMUM  SMALL  BUFFERS 

130  MAXIMUM  LARGE  BUFFERS 

131  LARGE  BUFFER  SIZE 

140  MINIMUM  RECEIVE  BUFFERS 


F.8. 2   System  Counters 


Number 

0 
10 
20 
30 
40 


Standard  text 

Seconds  since  last  zeroed 
Control  buffer  alicKation  failed 
Small  buffer  allocation  failed 
Large  buffer  allocation  failed 
Receive  buffer  allocation  failed 


F.9   X.25  Access  Module  Parameters 


Number 


Keywords 


2310 

DESTINATION 

2320 

NUMBER 

2330 

SCOPE 

F.10   X.25  Protocol  Module  Parameters  and  Counters 


F.10.1    x.25  Protocol  Module  Parameters 


Number 


Keywords 


0 

STATE 

100 

COUNTER  TIMER 

1100 

DTE 

1101 

GROUP 

1110 

NETWORK 

1120 

LINE 

1140 

DEFAULT  DATA 

1141 

DEFAULT  WINDOW 

1150 

MAXIMUM  DATA 

1151 

MAXIMUM  WINDOW 

1152 

MAXIMUM  CLEARS 

1153 

MAXIMUM  RESETS 

1154 

MAXIMUM  RESTARTS 

1160 

CALL  TIMER 

1161 

CLEAR  TIMER 

1162 

RESET  TIMER 

llft3 

RESTART  TIMER 

1170 

DTE  (qualified  bv  GROUP) 

1171 

NUMBER 

1172 

TYPE 
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F.I 0.2   X.25  Protocol  Module  Counters 


Number 

Standard  text 

0 

Seconds  since  last  ziroed 

10()0 

Bytes  received 

1(H)1 

Bytes  sent 

1010 

Data  blocks  received 

1011 

Data  blocks  sent 

liof) 

Calls  received 

1201 

Calls  sent 

1210 

Fast  selects  received 

1211 

Fast  selects  sent 

1220 

Maximum  switched  circuits  active 

1221 

Maximum  channels  active 

\2:M) 

Received  call  resource  errors 

1240 

Locally  initiated  resets 

1241 

R?motely  initiated  resets 

1242 

Network-initiated  resets 

12nO 

Restarts 

F.11    X.25/X.29  Server  Module  Parameters  and  Counters 


F.11.1    X.25/X.29  Server  Module  Parameters 


Number 


Keywords 


0 

STATE 

100 

COUNTER  TIMER 

3(X) 

DESTINATION 

310 

MAXIMUM  CIRCUITS 

340 

OBJECT 

350 

PRIORITY 

351 

CALL  MASK 

352 

CALL  VALUE 

353 

GROUP 

354 

NUMBER 

355 

SUBADDRESSES 

F.1 1.2   X.25/X.29  Server  Module  Counters 


Number 


standard  text 


0 
2(XI 
210 
211 


Seconds  since  last  zeroed 
Maximum  circuits  active 
Incoming  calls  rejected,  no  resources 
Logical  links  rejected,  no  resources 
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INDEX 


Abhreviatin^:  command  keywords.  H-5 
Access  control  information. 

formats  for.  ■2-4 

to  specify  for  remote  node.  (v83 

within  an  alias  node  name.  2-5 
Access  control  verification. 

to  specity.  2  •") 

to  specify  in  permanent  data  base. 
6-29.  H-44 

to  specity  in  volatile  data  base.  H-81, 
fi-129.  (M;U).  H-l.y 
Access  module,  sec  X.2n  access  module 
.Account  number  formats.  2  4 
ACTIVE  keyword.  M-7 
.Alias  node  name. 

blank  alias.  2-5 

defined.  2  5 

exam|)le  of  how  to  set.  2-5 

to  define  scope  for.  2  5 

to  display  alias  information,  6-104 

to  remove.  6-1 1 

to  specity.  6-78 
Alias  parameter  type  numbers.  F   1 
.ALL  kevword.  '\  7 


B 


Broadcast  address.  2  9 
BROADCAST  HOrTINC;  TLMEK 
parameter,  2-14 


Butler  counter  type  numbers.  K   10 
Butlers. 
see  also  System  commands 
allocating  memory  tor.  5  2 
butler  types  (table),  5  :\ 
control  butlers  (CCBs). 

sec  alsii  CCBs.  5  6 
counters  (system  counters!.  K   16 
lar^e  butter.s  (LI)Bsi. 

srr  al.^d  LDBs.  5  .'^ 
number  required  by  nodes.  5  5 
parameters,  5   1 
small  butlers  (SI)Bsl. 

scf  also  SDBs.  5  () 
system  parameter  type  numbers.  F  10 


CCBs. 

bar  firaphs  of  in  .\TI)  displays.  1 14 

intormation  table.  5  15 

usafje.  5-6 
CCR  (con.sole  carrier  requester).  7-1 
CCR, 

error  messages.  14  2 

introductory  description.  17 

sample  CCR  session.  7  2 

to  access  CCR.  7   1 

to  reserve  the  console.  7-2 
CpyiAB.MAC. 

errors  in.  144 

to  change  using  NF]TCFP].CMI),  5  1 


Index-I 


CETAB.MAC.  (Com.) 

to  modilV  using  CFE.  1-4 

riC  for.  6-1 
CFE. 

see  also  Utility  commands 

command  descriptions.  6-10 

command  summary.  A-2 

error  messages.  14-4 

general  description.  6-1 

KILL  command,  6-2 

LIST  command,  general  description. 
3-6 

to  exit.  6-2 

to  invoke.  6-1 

use  of  to  modify  the  permanent  data 
base.  1-4 
Channel  parameters.  2-31 
Checkpointing  RSX-llS  tasks.  4-11 
Circuit  commands, 

CLEAR  CIRCl  ;T  (to  zero  PSI  circuit 
counter  timer).  6-12 

DEFINE  CIRCriT.  6-26 

LIST  CIRCUIT.  6-50 

LOOP  CIRCUIT.  6-6o 

PURGE  CIRCUIT.  6-69 

SET  CIRCUIT.  6-79 

SET  CIRCUIT  (for  RSX-llS),  6-130 

SHOW  CIRCUIT.  6-105 

SHOW  CIRCUIT  (for  RSX-llS), 
6-134 

ZERO  CIRCUIT.  6-121 
Circuit. 

see  also  Circuit  commands 

circuit  ID. 
DECnet  format  of.  2-23 
DLM  format  of.  2-25 
PSI  format  of.  2-25 
to  modify,  2-23 

cost,  and  relationship  to  path  cost 
(figure).  2-12 

cost,  to  modify.  2-13 

counter  type  numbers.  F-2 

counters.  2-31.  E-2 

DDCMP  circuits.  2-21 

DLM  circuit  parameters.  2-30 

DLM  circuits,  2-22 

F^thernet  circuit  parameters.  2-30 

Ethernet  circuits.  2-21 

multipoint  circuit,  defined,  2-21 

ownership.  2-27 

parameter  type  numbers.  F-2 

parameters  (table).  2-24 

parameters,  to  specify,  2-25 

PCL  circuits.  2-21 


Circuit.  (Cont.) 

point-to-point  circuit,  2-21 

PSI  circuit  parameters.  2  31 

PSI  circuits.  2-22 

PVC,  defined,  2-22 

states  and  loading.  2-25 

states  and  substates  (table).  2-26 

substates.  2-27 

SVC.  defined.  2-22 

to  turn  on.  3-2 

types.  2-21 
CLEAR  commands  (descriptions).  6-11 

to  6-25 
Command  summaries, 

CFE.  A-2 

NCP  (full  set).  A-7 

NCP  (RSX-llS  only).  A -14 

VNP.  A- 16 
Comment  line  format.  6-5 
Configuration  File  Editor. 

see  CFE 
Console  carrier  requester. 

see  CCR 
Continuation  lines  within  commands.  6-5 
Controller  CSR  address, 

to  modify.  2-19 
Counter  timer. 

to  zero  PSI  circuit  counter  timer.  6-12 

to  zero  PSI  line  counter  timer.  6-15 
Counter  type  numbers, 

for  circuits.  F-2 

for  lines.  F-4 

for  nodes.  F-9 

for  system  buffers.  F-10 

for  X.25  protocol  module.  F-11 

for  X.25/X.29  server  modules.  F-11 
Counters. 

for  buffers  (system  counters).  E-16 

for  circuits.  2-31.  E-2 

for  lines.  2-20.  E-6 

for  nodes.  2-8.  E- 13 

for  X.25  modules.  2-43 

for  X.25  protocol  module.  E-11 

for  X.25/X.29  server  modules.  E-12 

general  description.  2-34.  E-1 

summary.  E-1 

timers  for  logging  counters.  2-36 

to  display.  2-35 

to  log.  2-36 

to  zero.  2-35 

type  numbers.  F-1 
Crash  analysis, 

crash  causes.  10-3 

obtaining  a  crash  dump.  10-3 
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Crash  analysis,  (Cont.) 
ii[i-line  dumping.  4  7 
usin»;  N'DA. 

srr  (ilsn  NDA.   10    1 


Data  link  mapping,  s^•^•  DLM 
DCE. 
defined,  1    1 

i)i)('Nn\ 

circuit  counter  type  numbers.  F  '^ 

circuit  II)  format.  L'  l2M 

lircuit  owners.  '2  '1~ 

circuit  parameters  (table).  2  24 

circuits.  2  21 

in  a  >am[)le  Phase  I\'  configuration 

(figure  I.  1   .'^ 
JHU'  counter  type  numbers.  K  4 
Hne  counters.  2  20 
line  devices.  2   IH 
line  parameters  (tablet.  2   19 
line,  defined.  2   Hi 
multipoint  circuit  parameters.  2  28 
DEAD  TIMKH  {)arameter  valuer.  2  29 
DKCnet. 
configuration>.  1   M 
e.xample  of  Phase  I\'  configuration 

(figure).  1-.'^ 
interface  with  RSX  operating  systems, 
11 
DKCnet-RSX. 
command  files.  15 
data  bases  and  related  utilities.  1-4 
device  drivers  and  processes  (table). 

2-.SS 
shutdown.  A  '.\ 
startup.  :^-l 

startup,  using  NCF^  commands.  :\  2 
startup,  using  the  NP:TINS.C'Mn  file. 

3-2 
startup,  using  VNP  commands.  3-2 
steps  to  produce  a  running  system 

(figure).  \-(i 
steps  to  produce  a  running  system 
(list).  1-H 
DEFINE  cf)mmands  (descriptions).  6  26 

to  6-48 
DELAY  TIMER  parameter  values,  2-29 
DEQNA.  2-17 

Designated  router.  2-10.  2-30 
DErNA.  2-17 

Device  drivers  and  processes  (table). 
2-38 


Devices. 

lor  DDCMP  lines.  2  16 

lor  Ethernet  lines,  2   16 

for  PCL  lines.  2   16 

for  PSI  lines.  2   17 

line  types  (table).  2   17 
Display  commands,  see  LI.ST  and 

SHOW  commands 
DLM  (data  link  mapping). 

defined.  1    1 
DLM. 

circuit  ID  format.  2  2") 

circuit  parameters.  2-30 

circuit  parameters  (table).  2-24 

circuit  recall  parameters.  2  30 

circuits.  2  22 

in  a  sample  Phase  IV  configuration 
(figure).  13 
DLX  as  circuit  owner.  2  27 
DMC   11.2   16 
DMP  polling  rates.  2  29 
D.MP  11.  2   16 
DMR   11.  2   16 
DMV  polling  rates.  2-29 
DMV  11,  2  16 
Down-line  loading. 

scr  nl.sd  Down-line  task  loading 

introduction.  4   1 

NCP  load  commands.  4-3 

NCP  load  commands. 
LOAD  NODE.  6-61 
LOAD  VIA.  6-63 

parameter  list.  4  4 

parameters  for  load  files.  4  6 

parameters  for  the  target  node,  4-5 

set-up  requirements.  4-3 

setting  up  an  RSX- 1  IS  system  image 
file.  4-2 
Down-line  task  loading. 

checkpointing  RSX-US  tasks.  4   11 

figure.  4-10 

general  description.  4-9 

overlaying  RSX- US  tasKs.  4  11 

prerequisites  for.  4-9 
DTE. 

defined,  1-1 

parameters,  2-39 

parameters  (table).  2-40 

to  shut  down.  3-5 

to  specify  remote  DTF^  address.  2-30 
DUPll-DA.  2  17 
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End  node.  2  11 
Error  messages. 

tor  CCR.  \\  2 

for  CFE.  14-4 

for  HLD.  14-18 

for  NT  P.  14  25 

for  NCP  (message  formats),  14  2.'^ 

for  M)A.  14  .^9 

for  NTI).  14  a:\ 

for  NTDEMO.  14  4.> 

tor  NTIMT.  14-44 

for  NTL.  14  47 

for  THI.  14  .'>H 

tor  V\F.  14  .")S 
ESCAPE  kev  usage  Inr  help  mtormation. 

Flthernet  addresses. 

broadca>t  address.  2-9 

format.  2  H 

general  description.  2  ^ 

hardware  address.  2-9 

multicast  address  types.  2  9 

multicast  addre>s  values.  2  10 

physical  addres>.  2  9 

physical  address  values.  2   10 
Ethernet. 

see  ai'^'i  Ethernet  addresses 

broadcast  routing  timer.  2   14 

circuit  counter  type  numbers.  F  .'^ 

circuit  II)  format.  2-2M 

circuit  parameters.  2  '^0 

circuit  parameters  i  table).  2  24 

circuits.  2  21 

designated  router.  2   10 

example  (•(  Phase  I\'  i-onfiguration 
( tiguret.  1   '\ 

line  counter  type  numbers,  F-5 

line  counters.  2  20 

line  devices.  2-16 

line,  defined.  2   H^ 

maximum  number  o(  routers.  2  -'^0 

routing  parameters  (table).  2  11 
Event  logger  interlace.  ("1 
Event  logging. 

>♦■'■  L<igging.  Events,  and  E\ent 
messages 
Event  messages, 

for  data  link  layer.  I)  1 1 

for  end  communications  layer.  I)-o 

lor  network  management  laver.  D  A 

for  physical  link  layer.  1)14 

for  RSX  system-specific  events.  D   1") 


Event  messages,  (Cont.) 

for  session  c<'ntrol  layer,  1)  "i 

for  transport  layer.  I)  6 

format.  I)  2 
Events. 

sec  a/.sry  Event  messages  and  E<»gging 

class  and  tv|)e.  >pecitying.  2  -VA 

detined.  2  H2 

event  cla.sses  (table).  I)   1 

event  list  format.  2  AA 

event  message  format,  I)  2 

list  of  logging  events.  F  6 

logging.  2    ^2 
Executor  commands, 

("LEAR  EXECITOR.  6  \:\ 

CLEAR  EXECITOR  NODE.  6  14 

DEFINE  EXECCTOR.  H  29 

LIST  EXECCTOR.  (>  r>i 

LOOP  EXECCTOR.  r,  >W 

LOOP  EXECCTOR  (for  RSX   US). 
6   129 

SET  EXE(T  TOR.  {\  h\ 

SET  EXECCTOR  HOST  (f(.r 

RSX- US),  6 -in 

SET  EXECCTOR  NODE.  6  a:] 

SHOW  EXECCTOR.  6  10(i 

SHOW  EXECCTOR  dor  RSX  US). 

H  i;c> 
ZERO  EXECCTOR.  H  122 
ZERO  EXECCTOR  (for  RSX  IIS). 
H  141 

EXE(TT()R  keyword,  usi-  of.  2  :] 

F^xecutor  node. 
XT  also  Executor  commands 
defined.  2-2 
ID  string.  2-H 
subaddres.ses,  2-H 


File  Transfer  Spooler,  vcc  FTS 
FTS  (File  Transfer  Spooler).  12   1 
FTS. 
Kimponents  (figure).  12  2 
components  (table).  12  2 
to  list  and  purge  CRH  tiles.  12  H 
to  list  FTSQCE  and  FTS  jobs.  12  G 
to  purge  FTSSYS.LOC.  and  FAL.LOC. 
12  (5 


firou|)-reiated  parameters.  2  4o 
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H 


Hardware  address, 

defined.  2  H 

HAHDWARF.  ADDF^KSS  parameter. 
I  :> 
HKI.LO  riMKR  parameter. 

t<-  modit'v.  2   \\ 
Hel[)  int«»rmati(»n.  <i  .") 
HI. I).  4  H.  4   11 
HI. I)  (Ho>t    Ta-^k  Loader t.  '^   ] 
HI. I). 

e(>mmand>.  'i  2 

errnr  handlinij.  **  ■'< 

error  mes«at:es.  14   1>^ 

nitrodu('tor\  dest  riptioti.  1    7 

LI  \  tixm^:.  A  ^ 

to  create  moditv  a  map[)in^  table.  *^  2 

to  tormat  the  mapping  table,  H   1 
Hop>. 

MAXIMLM  HOIN  parameter.  2   IM 
Ho<t   Task  Loader,  ->>   HL!) 


\\l).\  iKMX  dump  analvzer).  9   1 
KDA. 

KI).\  (.ommand.  9  2 

KD.A  command  switches  itablel,  9  2 

t(.  exit.  9   1 

to  invoke.  9-1 
KILL  command  iv'KF).  fv2 
KM.^11    HI).  2   17 
KM.^ll    LX.  2   17 
KMX  diHTip  analyzer,  ><•<'  KD.A 
KMX  intertace.  2   17 
K.MX  DLML  command.  H  49 
KNOWN  CIHClirS  keyword.  2  2M 
KNOWN  keyword.  M  7 
KNOWN  LINK.S  kevw(.rd.  2   \X 
KNOWN  NODKS  kevword,  defined.  2  3 


• 


LAPB, 

line  counter  tvpc   numl)er>.  V  5 
LDBs. 
bar  Kra[)h«-  o|  in  NTI)  di>pla\>.  1  1    .'> 
intormation  table,  •">  ■\ 
number  rec^uired  by  ditterent  desice 

types  (table).  '>-.') 
to  determine  nuinber  to  allocate,  a  4 
to  determine  size  ot.  'i  :< 
u^aye.  o  :? 


Line  commands, 

CLKAH  LINK  ito  unl<.a(i  line  /en.  PSI 
line  counter  timer),  <>   I'l 

DKKINK  LINK,  H  :V2 

LIST  LINK,  »i  r>2 

LOOP  LINK.  H  fr. 

ITHCiK  LINK.  ♦;  70 

SKT  KNOWN  LINKS,  ♦)  H4 

SKI'  LINK,  »;  H(; 

SKT  LINK  (for  KSX   llSi.  H   1M2 

SHOW  LINK,  H   107 

SHOW  LINK  (tor  KSX    llSi,  (i   i:m 

ZKHO  LINK.  ♦;  12;^ 

/.KKO  LINK  <tor  HSX    11  Si.  r,   142 
Line. 

^<  (■  a/so  Line  conimands  and  line 
entries  under  LSI 

counter  tvpe  numbers.  V  4 

counters,  2  2<).  K  *i 

DDOML  devices.  2   H^ 

device  tvpe>  ( table).  2    17 

Kthernet  devices.  2   Hi 

line  II)  tormat.  2   \X 

parameter  tvpe  numbers.  V  4 

parameters  (table).  2   19 

parameters,  loaded  vs.  loading  options. 


2 -IS 


parameters,  to  specify,  2   IH 

\'C\.  devices.  2   lb 

PSI  devices.  2   17 

stales  and  substates  (table).  2  26 

states,  to  set  and  display,  2  20 

t(«  load.  2  20 

t(j  load  turn  on,  '\  2 

to  shut  down  a  DKCnet  line,  3;^ 

to  unl(»ad,  b  If) 

tyj)es.  2   1b 
LIST  command. 

fieneral  description,  3  b 
LIS'I'  commands  (descriptions),  (i  oO  to 

6  bO 
LOAD  command,  use  ot.  4  3 
LO.AI)  commands  (descriptions).  (>  (U  u 

fi  b4 
Loading/turninf:  on  a  line,  3  2 
Local  node. 

defined.  2  2 
Lo^'-in  II).  defined,  2  4 
Loj/gm^  c-ommands, 

CLKAH  LOCK  I! NO.  b  lb 

DKKINK  L()(;(;iN(;.  b  :r> 

LIST  LOCCilNO.  b  r,.3 

prRf;K  LO(;(;iN(;.  o  71 

SKT  LOCOLNC.  b  H9 
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l><)gging  commands.  (Cont.) 

NCP.  (Cont.)                                                                        ^^ 

SET  LOGGING  CONSOLE  (for 

command  descriptions  (full  set).  6-10                               ^^W 

RSX-US),  6-133 

command  descriptions  (RSX-llS  only),                           ^^^ 

SHOW  LOGGING.  6-108 

6-128 

SHOW  LOGGING  CONSOLE  (for 

command  set  descriptions.  1-5 

RSX-llS).  6-137 

command  summary  (full  set).  A-7 

Logging. 

command  summary  (RSX-llS  only). 

see  also  Events  and  Logging  commands 

A-14 

commands,  summarized.  2-32 

down-line  load  commands,  4-3 

components.  2-33 

error  message  formats.  14-23 

defined.  2-32 

error  messages  (listing  of),  14-25 

event  classes  (table).  D-1 

general  description.  6-2 

event  logger  interface.  C-1 

remote  execution.  6-3 

event  logging,  coding  example.  3-10 

SHOW  command. 

event  message  format.  D-2 

general  description.  3-6 

events,  list  of.  F-6 

sample  displays.  3-8 

parameter  type  numbers.  F-6 

to  exit.  6-3 

parameters  (table).  2-32 

to  invoke.  6-2                                                                       ^^k 

to  display  logging  information.  6-53. 

to  send  display  information  to  a  file,                                 ^^^ 

6-108 

3-8 

to  display  logging  information  (for 

use  of  to  modify  the  volatile  data  base, 

RSX-llS).  6-137 

1-5 

to  specify  logging  parameters.  6-89 

use  of  to  start  up  DECnet-RSX.  3-2 

LOOP  command  (RSX-llS).  6-129 

use  of  to  start  up  DECnet-RSX/PSI. 

LOOP  commands  (descriptions).  6-65  to 

3-4 

6-68 

NDA  (Network  Dump  Analvzer).  10- 1 

Loop  node,  defined.  2-4 

NDA,                                                                                     ^^ 

Loopback  tests. 

analysis  control  switches.  l(,'-7                                             ^^B 

see  also  LOOP  commands 

analysis  control  switches  (table).  10-8                                ^^ 

general  description.  3-11 

command  syntax.  10-4 

LUN  fixing.  8-3 

crash  causes.  10-3 

error  messages.  14-39 

M 

file  default  values  (table),  10-5 

function  control  switches.  10-7.  10-9 

Mailbox. 

function  control  switches  (table).  10-10 

contents  returned  by  GND.S.  C  -2 

introductory  description.  1-7 

defined.  C-1 

operation  of.  10-2                                                                   ^^^ 

Mapping  table,  see  HLD 

requirements  for  use.  10-2                                                    ^^^ 

MAXIMUM  ADDRESS  parameter. 

to  obtain  a  crash  dump.  10-3 

to  modifv,  2-11 

to  run  NDA  as  an  installed  task.  10-4 

MAXIMUM  COST  parameter,  2  13 

to  run  NDA  as  an  uninstalled  task. 

MAXIMUM  HOPS  parameter.  2-13 

10-4 

Multicast  address  types.  2-9 

to  use  indirect  command  files.  10-6 

Multicast  address  values.  2-10 

NET(TE.(^MD  file.  1-5.  5-1 

Multipoint  circuit. 

NETCFE.CMD  file  (figure).  5-2 

DDCMP  parameters.  2-28 

NETGEN. 

defined.  2-21 

where  NETGEN  ends  and  system 

operation.  2-28 

management  begins,  1-5 

Multipoint  controller  polling  rates.  2-29 

NETINS.CMD  file.  1-5.  16 

NETINS.CMD  file. 

N 

used  tr  vart  up  DECnet-RSX   3  2 

NETREM.CMD  file,  1-5 

NCP. 

NETUIC,                                                                              ^^ 

see  also  Utility  commands 

to  set  in  system  image  file,  6-3                                         ^^P 
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Network  butter  parameters.  5-1 
Network  Control  Program.  ><'<•  NCP 
Network  Display  Program,  ><•(■  NTD 
Network  Dump  Analyzer,  sec  NDA 
Network  generation, 

where  NETGEN  ends  and  system 
management  begins,  1-5 
Network  initializer,  see  NTINIT 
Network  loader,  see  NTL 
Network  management  t(K)ls. 

see  CCR.  HLD,  KDA.  NDA,  NTD. 
QUE.  TRI 
Network  management. 

see  also  Utility  commands 

command  descriptions.  6  1 

command  summary.  A-1 

command  usage.  6-4 

component  descriptions.  2-1 

counter  type  numbers.  F-1 

overview.  1-1 

parameter  type  numbers.  F-1 

responsibilities  of  system  manager.  1-3 

steps  to  produce  a  running  system 
(figure).  1-6 

steps  to  produce  a  running  system 
(list).  1-6 
Node  address. 

defined.  2-3 

for  Ethernet.  2-8 

MAXIMUM  ADDRESS  parameter. 
to  modify.  2-11 
Node  commands. 

see  also  Executor  commands 

CLEAR  NODE,  6-21 

DEFINE  NODE.  6-42 

LIST  NODE,  6-57 

LOAD  NODE.  6-61 

LOAD  VIA.  6-63 

LOOP  NODE,  6-68 

LOOP  NODE  (for  RSX-llS).  6-129 

PURGE  NODE.  6-75 

SET  NODE  CIRCUIT.  6-96 

SET  NODE  NAME.  6-97 

SHOW  NODE.  6-113 

SHOW  NODE  (for  RSX   US),  6-138 

TRIG(;ER  NODE,  6-119 

TRIGGER  VIA.  6-120 

ZERO  NODE.  6-126 

ZERO  NODE  (for  RSX-llS).  6-143 
Node  ID.  defined.  2-3 
Node  name,  defined.  2-3 
Node. 

see  also  Node  commands 


Node.  (Cont.) 
access  control  information 

requirements.  2-4 
access  control  verification.  2  5 
alias  node  names.  2-5 
buffer  requirements.  5  5 
counter  type  numbers.  F  9 
counters.  Fl-li^ 

counters,  general  description,  2-8 
end  node  (nonrouting).  2  11 
Ethernet  address  of  node,  2-8 
loop  node,  defined.  2-4 
node  address,  defined.  2-3 
node  ID.  defined.  2-3 
node  name,  defined.  2  3 
parameter  type  numbers.  F  8 
parameters.  2-6 
parameters  (table),  2  7 
routing  node,  2  10 
to  bootstrap,  6-119 
to  down-line  load  a  remote  node.  6-61. 

6-63 
to  shut  down.  3-3 
to  startup.  3- 1 
ty^es.  2-2.  2   10 
NTD  (Network  Displav  Program).  11-1 
NTD. 
command  mode  commands,  11-2,  11-3 
command  mode  commands  (table). 

11-4 
command  modes.  11-2 
display  types,  11-1 
error  messages.  14-43 
format  of  default  resource  display 

(figure).  11-5 
format  of  node  summary  display.  11-7 
format  of  node  summary  display 

(figure),  11-8 
format  of  old  resource  display  (figure), 

11-6 
format  of  resource  display.  11-4 
immediate  mode  commands.  11-2 
immediate  mode  commands  (table), 

11-3 
introductory  description.  1-8 
scrolling  commands.  11-3 
to  invoke.  11-2 
NTDEMO  error  messages.  14-43 
NTINIT  error  messages,  14-44 
NTL  error  messages.  14-47 
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Object  commands, 
CLEAR  OBJECT.  6  22 
DEFINE  OB.IECT.  H  44 
LIST  OBJECT.  (V  58 
PrR(^,E  OBJE(^T.  6  77 
SET  OBJECT.  6  98 
SHOW  OBJPXT.  6-114 

Object  type  codes, 
table.  B-1 
values.  2-14 

Object. 
.src  also  Object  commands 
access  control  veritication.  2-5 
defined.  2  14 
multicopy  objects,  2-15 
name  format.  2-15 
parameter  type  numbers.  F-9 
parameters  (table).  2-14 
riCs.  2  15 

Overlaying  RSX-llS  tasks.  4-11 


Parameter  type  numbers, 
for  alias  parameters.  F-1 
for  circuit  parameters.  F-2 
for  line  parameters,  F-4 
for  logging  parameters.  F-ii 
tor  node  parameters.  V-S 
for  object  parameters.  V-9 
for  process  parameters.  F-9 
for  svstem  (bufferl  parameters.  V~U) 
for  X.25  access  module  parameters. 

F-10 
for  X.25  protocol  module  parameters. 

F-IO 
tor  X.25  X. 29  server  module 

parameters.  F  1 1 
Password, 
format  of  for  access  control,  2-4 
receive  j)ass\vord.  to  remove.  H-l.S 
receive  password,  to  specify.  (v81. 

H   129.  6  1. SO.  6-i;U 
transmit  password,  to  remove.  6- Hi 
transmit  password,  to  specify.  6-81, 

6-129.  6  i:U).  6  i:U 
Path  cost. 
M.XXIMCM  CO.ST  parameter.  2-ia 
relationship  to  circuit  cost  (figure). 

2   12 
PCL. 
circuit  ID  format,  2  23 


PCL.  (Cont.) 

circuit  parameters  (table),  2-24 

circuits.  2-21 

device  counter  type  numbers,  V-^y 

line  devices.  2   16 

line,  defined.  2-16 
Permanent  data  base, 

CFK  command  functions,  2-1 

defined.  14 

to  modify  using  CFF^.  14 
Permanent  virtual  circuit. 

defined,  2-22 
Phase  IV  sample  configuration  (figure). 

1  -a 
Physical  address, 

defined,  2-9 

PHYSICAL  ADDRESS  parameter.  4  5 

set  by  the  HARDWARE  ADDRESS 
parameter.  4  5 

to  reset  to  hardware  address,  2   17 

values.  2-10 
Point-to-point  circuit,  2-21 
Polling. 

for  DMP  and  DMV  multipoint 
controllers,  2-29 

general  description.  2-28 

ratios.  2-28 
Process  commands, 

CLEAR  PROCESS.  6-23 

DEFINE  PROCESS.  6  46 

LIST  PROCESS,  6-59 

SET  PROCESS.  6- 100 

SHOW  PROCESS.  6-115 
Process, 

sec  also  Process  commands 

general  description.  2-36 

MAXIMCM  CONTROLLERS 
parameter,  2-37 

MAXIMUM  LINES  parameter,  2-37 

names  and  types  (table).  2-38 

parameter  type  numbers,  F-9 

parameters  (table).  2-37 

states.  2-37 

to  load.  2-37 
Protocol  module,  sec  X.25  protocol 

module 
PSI, 

X.25  access  module,  see  X.25  access 
module 

X.25  protocol  module,  sec  X.25 
protocol  module 

X.25/X.29  server  modules,  see 
X.25/X.29  .server  modules 

channel  parameters.  2-31 


C 
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PSI.  (font.) 

circuit  in  format.  2-2o 

circuit  parameters.  2-.'^l 

circuit  parameters  (table),  2  24 

cif-cuits.  2  22 

defined.  11 

device  drivers  and  proces.ses  (table), 
2  :W 

line  counters.  2  20 

line  devices.  2   17 

line  parameters.  2  20 

line  parameters  (table).  2  19 

line,  defined.  2   1(5 

logical  destination  names,  to  create. 
2-42 

module  counters.  2  43 

module  types,  defined.  2-:^9 

to  load. turn  on  a  line.  :^-4 

to  shut  down  a  line  or  DTFl.  ;^  o 

to  shut  down  a  module.  Mo 

to  startup.  ^-'-^ 

to  startup  usiny  NCP  commands.  .'^-4 

t(t  startup  usin^'  VNP  commands.  'A  4 

to  zero  the  circuit  counter  timer.  fi  12 

to  zero  the  DTK  counter  timer,  (i-19. 
B-TM 

to  zero  the  line  counter  timer.  H-lo 
PSN.  defined.  11 
PlRCiK  commands  (descriptions).  B  ()9 

to  B  77 
P\C.  defined.  2-22 


(^NA.  2   IB 

(^I'K  (C^ueue  Manatreri.  12   1 

giK. 

command>.  12  '^ 

components  (tiyurel.  12  2 

components  (table).  12  2 

introductory  description.  1  S 

to  i!iv<)ke.  \'2-'-\ 

to  li>t  and  purge  TRB  files.  12-H 

Queue  management  functions.  12  o 

Queue  Manauer.  ><  i  (^IK 

(Quoted  string.  2-4.  2  B 


Receive  password,  src  F^a^word 
Remote  command  execution. 

fit  S(V  (ommands.  B-;^ 

to  uiitiate.  B  S;< 

to  return  control  to  local  node.  B  14 


Remote  node,  defined.  2-2 
Routing  layer. 

sc«'  Transport  layer 
Routing  node,  defined.  2   10 
ROITINC.  TIMP:R  parameter.  2  I'i 
Routing. 

defined.  2-10 

designated  router.  2-.U) 

MAXIMl'M  BROADCAST  ROITKRS 
parameter  (for  F.thernet).  2-.'^0 

parameters  (table).  2-11 

timers.  2-  \'-^ 
RSX    lis. 

si'f  also  rntrir.s  under  Down-line 
loading  and  I'p-line  dumping 

down-line  loading.  4   1 

down-line  task  loading.  4  9 

SCV  command  descriptions.  B  12H 

XrP  command  summary.  A   14 

setting  up  a  system  image  file.  4  2 

to  down-line  load  a  remote  node.  (>  Bl. 
B-Ba 

up-line  dumping.  4  7 


s 


Satellite  task  loader,  srr  SLD 
Scope  for  specifying  aliases.  2  o 
SDBs. 

bar  graphs  ot  in  NTD  displays.  1 1   o 

information  table,  o  H 

usage.  o-B 
Secondary  loader.  4  B 
Server  modules,  src  X.2")/X.29  server 

modules 
SKRVKT:  password  parameter.  4  o 
SKT  commands  (descri|)tions).  B-78  to 

B-IOM 
Spyr  commands  for  RSX   US 

(descriptions).  B  \:M)  to  B   \'.VA 
SFT  KXKCTTOR  HOST  command  (for 

RSX  US).  Bi;n 

SF/r  FXFCITOR  NODF  command. 

format.  B-83 

usage.  B  'A 
SHOW  command. 

general  description.  A  B 

sample  displays.  :\  M 
SHOW  commands  (descriptinns).  B  104 

to  B   117 
SHOW  commands  for  RSX   US 

(descriptions).  B   \'M  to  B   i;i9 
Shutting  down  DFCnet    RSX.   '.  H 
Shut  tin*'  down  PSI.  :•!  .') 
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SIGNIFICANT  keyword,  3-7 

SLD.  4-9.  4-11.  8  1 

SLD.  UN  fixing.  8-H 

Starting  up  DECnet-RSX,  3-1.  3-2 

Starting  up  DECnet-RSX/PSI.  3-3.  3-4 

SIB.ADDRESSES  parameter  values,  2-8 

SV(\  defined.  2-22 

Switched  virtual  circuit,  sec  SVC 

Svstem  commands. 

CLEAR  SVSTEM.  6-24 

DEFINE  SVSTEM.  6-47 

LIST  SVSTEM.  6-60 

SET  SVSTEM.  6-102 

SHOW  SVSTEM.  6-116 

SHOW  SVSTEM  (for  RSX-llS), 
6-139 

ZERO  SVSTEM.  6-127 

ZERO  SVSTEM  (for  RSX-llSl.  6-144 
.System  counter  type  numbers,  F-10 
System  counters.  E-16 
System  image  file. 

defined.  1-4 

to  modify  using  VNP.  1-4 

VNF  command  functions.  2-1 
System  management. 

see  Network  management 
System  parameter  type  numbers.  F-10 


TELL  command, 

format.  6-118 

usage.  6-3 
Tertiary  loader.  4-6 
Trace  commands. 

CLEAR  TRACE.  6-2n 

SET  TRACE,  6  103 

SHOW  TRACE.  6  117 
Trace  facility,  3-11,  13-1 
Trace  facility,  see  also  TRI 
Trace  interpreter  task,  see  TRI 
Trace  output  information.  13-3 
Transmit  password,  see  Password 
Transfjort  layer. 

as  circuit  owner.  2-27 

routing  function,  2-10 
TRI  (tr^ce  interpreter  task),  13-1 
TRI, 

command  format.  13-2 

command  switches  (table),  13-2 

contents  of  trace  output.  13-3 

error  messages,  14-56 

introductory  description.  1-8 

to  exit  TRI,  13-2 


TRI,  (Cont.) 

to  invoke  TRI.  13-1 
Tributaries. 

dead  polling  rates.  2-29 

polling  of.  2-28 

types  of.  2-28 
TRICiCiER  command, 

formats,  6-119  to  6-120 

use  of.  4-3 
Type  numbers  for  parameters  and 
counters,  F-1 


u 


riCs.  2-lo 

UNA.  2-16 

CNIT  CSR  parameter,  2-19 

I'p-line  dumping. 

introduction.  4-7 

parameters,  4-8 

procedures,  4-8 

requirements  for.  4-7 
IRB. 

to  list  and  purge  CRB  files.  12  8 
Cser  ID.  defined.  2-4 
Utility  commands, 

see'alsn  CFE,  NCF,  VNP,  and 
Command  summaries 

abbreviating  a  keyword,  6-5 

command  prompting  (for  help),  6-6 

comment  lines,  6-5 

continuing  a  command  line.  6-5 

descriptions  of  (for  RSX-llS).  6-128 

descriptions  of, 
formats.  6-10 
introduction,  6-7 
parameter  definitions,  6-8 

error  handling,  6-6 

exit  status.  6-6 

format.  6-4 

HELP  command  usage.  6-5 


Virtual  Network  Processor, 

see  VNP 
VMR. 
used  to  create  an  RSX-llS  system 

image  file,  4-2.  4-9 
used  to  install  SLD  in  the  RSX-llS 

system  image  file.  4-9 
used  to  set  NETl'IC  in  system  image 
file,  6-3 
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VNP. 

>»•»'  also  I'tility  commarKls 

command  desi-rijjtions.  H  Id 

riimmand  svinimary.  A    Hi 

errtir  messat:e>.  14  "iS 

t:eiu>ral  description,  i'->  '■'< 

SHOW  command,  general  description, 

:\  fi 
to  exit.  ♦;  4 
to  invoke.  H  4 

u>e  ol  NF/nic,  r>  :\ 

use  (•!  to  ireate  an  K.^X    i]S  system 

image  tile.  4  2 
use  of  til  jp.odilN  the  sv>tem  image  file, 

1    4 
u>e  ot  to  start  up  DKCnet   H.S\.  :\  2 
use  ot  to  start  up  DKCnet   K.s\  I'SI. 

:^4 
N'ojatile  data  base, 
defined.  1   "i 

\('!*  I'ommand  (unctions.  '2   1 
tti  moditv  usirit;  NCI'.  1   •'> 


X.'2.'>  access  module.  (Cont.l 

to  remove  destination  name.  T)  7_' 

to  remove  destination  nameisi.  ti   1^ 

to  specit>'  a  destination  nami'.  ti  ■W\ 
H  HI 
X.li")  circuit  counter  t\[)e  numbers.  F  i^ 
\.2r)  protocol  module. 

counter  ty[)e  numbers.  K    11 

counters.  2  A'\.  K   1 1 

delined.  2  :U» 

parameter  type  numbers.  K   in 

parameters  (table).  2  4<i 
X.2.'>/X.29  server  modulo. 

counter  type  numbers.  F   11 

counters.  _    VA.  F   \2 

detined.  2  41 

parameter  type  numbers.  F    11 

parameters  i  tablet.  J  41 

to  set  the  state  lor.  2  4J 

to  shut  down.  :,'  -12.  '■''<  •"> 
XDT.  10  ;< 
X!*r  as  circuit  owner.  _'  27 


w 

Wildcard  character, 
in  circuit  IDs.  2  2M 
in  event  lists.  2  'i'^ 
in  line  IDs.  2   18 


X  2")  access  module, 
detined.  2  42 
{)arameter  t\pe  numbers.  F   in 


ZFK()  commands  uiesenptionsi.  »i   121  to 

♦>    127 
ZFKO  (ommands  tor  HSX    US 

idescri{)tionsi.  <i   14<i  to  (i   144 
Zero, 
how  to  zero  the  DTF,  counter  timer. 

♦i   H».  ti  7:i 
how  to  zero  the  F.SI  circuit  counter 

timer.  »>   12.  H  HW 
how  to  zero  thi'  PS!  line  (oimter  timer, 
fi   1."..  »i  7<i 
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NOTF:    This  form  is  for  document  .ommenis  only.  DIGITAL  will  use  comments  submitted  on  this  form  at  the 
company's  discretion.  H  you  require  jt  written  reply  and  are  eligible  to  receive  one  under  Software 
Performance  Report  (SPR)  service,  subnni  \  mir  comments  on  an  SPR  form. 


Did  you  find  this  manual  understandable,  usable,  and  well-organi/ed.'  Please  make  suggestions  for  miprovement. 


Did  you  find  errors  in  this  manual '   if  so.  specify  the  error  and  the  page  number. 


Please  indicate  the  type  of  user  read.'r  that  you  most  nearly  represent. 


n 

D 

a 

D 

D 
D 


Assembly  language  programmer 
Higlier-level  language  programmer 
Occasional  programmer  (experienced) 
l-'ser  with  little  programming  experience 
Student  programmer 
Other  (please  specify) 


Name. 


Date 


Organization, 
Street 


City. 


State 


Zip  Code 

or 
Country 
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